123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228 |
- 'use strict';
- var rbush = require('geojson-rbush');
- var square = require('@turf/square');
- var bbox = require('@turf/bbox');
- var truncate = require('@turf/truncate');
- var lineSegment = require('@turf/line-segment');
- var lineIntersect = require('@turf/line-intersect');
- var nearestPointOnLine = require('@turf/nearest-point-on-line');
- var invariant = require('@turf/invariant');
- var meta = require('@turf/meta');
- var helpers = require('@turf/helpers');
- function _interopDefaultLegacy (e) { return e && typeof e === 'object' && 'default' in e ? e : { 'default': e }; }
- var rbush__default = /*#__PURE__*/_interopDefaultLegacy(rbush);
- var square__default = /*#__PURE__*/_interopDefaultLegacy(square);
- var bbox__default = /*#__PURE__*/_interopDefaultLegacy(bbox);
- var truncate__default = /*#__PURE__*/_interopDefaultLegacy(truncate);
- var lineSegment__default = /*#__PURE__*/_interopDefaultLegacy(lineSegment);
- var lineIntersect__default = /*#__PURE__*/_interopDefaultLegacy(lineIntersect);
- var nearestPointOnLine__default = /*#__PURE__*/_interopDefaultLegacy(nearestPointOnLine);
- /**
- * Split a LineString by another GeoJSON Feature.
- *
- * @name lineSplit
- * @param {Feature<LineString>} line LineString Feature to split
- * @param {Feature<any>} splitter Feature used to split line
- * @returns {FeatureCollection<LineString>} Split LineStrings
- * @example
- * var line = turf.lineString([[120, -25], [145, -25]]);
- * var splitter = turf.lineString([[130, -15], [130, -35]]);
- *
- * var split = turf.lineSplit(line, splitter);
- *
- * //addToMap
- * var addToMap = [line, splitter]
- */
- function lineSplit(line, splitter) {
- if (!line) throw new Error("line is required");
- if (!splitter) throw new Error("splitter is required");
- var lineType = invariant.getType(line);
- var splitterType = invariant.getType(splitter);
- if (lineType !== "LineString") throw new Error("line must be LineString");
- if (splitterType === "FeatureCollection")
- throw new Error("splitter cannot be a FeatureCollection");
- if (splitterType === "GeometryCollection")
- throw new Error("splitter cannot be a GeometryCollection");
- // remove excessive decimals from splitter
- // to avoid possible approximation issues in rbush
- var truncatedSplitter = truncate__default['default'](splitter, { precision: 7 });
- switch (splitterType) {
- case "Point":
- return splitLineWithPoint(line, truncatedSplitter);
- case "MultiPoint":
- return splitLineWithPoints(line, truncatedSplitter);
- case "LineString":
- case "MultiLineString":
- case "Polygon":
- case "MultiPolygon":
- return splitLineWithPoints(line, lineIntersect__default['default'](line, truncatedSplitter));
- }
- }
- /**
- * Split LineString with MultiPoint
- *
- * @private
- * @param {Feature<LineString>} line LineString
- * @param {FeatureCollection<Point>} splitter Point
- * @returns {FeatureCollection<LineString>} split LineStrings
- */
- function splitLineWithPoints(line, splitter) {
- var results = [];
- var tree = rbush__default['default']();
- meta.flattenEach(splitter, function (point) {
- // Add index/id to features (needed for filter)
- results.forEach(function (feature, index) {
- feature.id = index;
- });
- // First Point - doesn't need to handle any previous line results
- if (!results.length) {
- results = splitLineWithPoint(line, point).features;
- // Add Square BBox to each feature for GeoJSON-RBush
- results.forEach(function (feature) {
- if (!feature.bbox) feature.bbox = square__default['default'](bbox__default['default'](feature));
- });
- tree.load(helpers.featureCollection(results));
- // Split with remaining points - lines might needed to be split multiple times
- } else {
- // Find all lines that are within the splitter's bbox
- var search = tree.search(point);
- if (search.features.length) {
- // RBush might return multiple lines - only process the closest line to splitter
- var closestLine = findClosestFeature(point, search);
- // Remove closest line from results since this will be split into two lines
- // This removes any duplicates inside the results & index
- results = results.filter(function (feature) {
- return feature.id !== closestLine.id;
- });
- tree.remove(closestLine);
- // Append the two newly split lines into the results
- meta.featureEach(splitLineWithPoint(closestLine, point), function (line) {
- results.push(line);
- tree.insert(line);
- });
- }
- }
- });
- return helpers.featureCollection(results);
- }
- /**
- * Split LineString with Point
- *
- * @private
- * @param {Feature<LineString>} line LineString
- * @param {Feature<Point>} splitter Point
- * @returns {FeatureCollection<LineString>} split LineStrings
- */
- function splitLineWithPoint(line, splitter) {
- var results = [];
- // handle endpoints
- var startPoint = invariant.getCoords(line)[0];
- var endPoint = invariant.getCoords(line)[line.geometry.coordinates.length - 1];
- if (
- pointsEquals(startPoint, invariant.getCoord(splitter)) ||
- pointsEquals(endPoint, invariant.getCoord(splitter))
- )
- return helpers.featureCollection([line]);
- // Create spatial index
- var tree = rbush__default['default']();
- var segments = lineSegment__default['default'](line);
- tree.load(segments);
- // Find all segments that are within bbox of splitter
- var search = tree.search(splitter);
- // Return itself if point is not within spatial index
- if (!search.features.length) return helpers.featureCollection([line]);
- // RBush might return multiple lines - only process the closest line to splitter
- var closestSegment = findClosestFeature(splitter, search);
- // Initial value is the first point of the first segments (beginning of line)
- var initialValue = [startPoint];
- var lastCoords = meta.featureReduce(
- segments,
- function (previous, current, index) {
- var currentCoords = invariant.getCoords(current)[1];
- var splitterCoords = invariant.getCoord(splitter);
- // Location where segment intersects with line
- if (index === closestSegment.id) {
- previous.push(splitterCoords);
- results.push(helpers.lineString(previous));
- // Don't duplicate splitter coordinate (Issue #688)
- if (pointsEquals(splitterCoords, currentCoords))
- return [splitterCoords];
- return [splitterCoords, currentCoords];
- // Keep iterating over coords until finished or intersection is found
- } else {
- previous.push(currentCoords);
- return previous;
- }
- },
- initialValue
- );
- // Append last line to final split results
- if (lastCoords.length > 1) {
- results.push(helpers.lineString(lastCoords));
- }
- return helpers.featureCollection(results);
- }
- /**
- * Find Closest Feature
- *
- * @private
- * @param {Feature<Point>} point Feature must be closest to this point
- * @param {FeatureCollection<LineString>} lines Collection of Features
- * @returns {Feature<LineString>} closest LineString
- */
- function findClosestFeature(point, lines) {
- if (!lines.features.length) throw new Error("lines must contain features");
- // Filter to one segment that is the closest to the line
- if (lines.features.length === 1) return lines.features[0];
- var closestFeature;
- var closestDistance = Infinity;
- meta.featureEach(lines, function (segment) {
- var pt = nearestPointOnLine__default['default'](segment, point);
- var dist = pt.properties.dist;
- if (dist < closestDistance) {
- closestFeature = segment;
- closestDistance = dist;
- }
- });
- return closestFeature;
- }
- /**
- * Compares two points and returns if they are equals
- *
- * @private
- * @param {Array<number>} pt1 point
- * @param {Array<number>} pt2 point
- * @returns {boolean} true if they are equals
- */
- function pointsEquals(pt1, pt2) {
- return pt1[0] === pt2[0] && pt1[1] === pt2[1];
- }
- module.exports = lineSplit;
- module.exports.default = lineSplit;
|