turf-line-slice-at-intersection

Slice a line whenever it intersects other features

turf.line-slice-at-intersection(line, segmenter)

Takes a LineString and a Feature to segment it by.

Any time the line intersects the feature, it will be segmented.

Parameters

parameter	type	description
line	Feature.<LineString>	line to segment
segmenter	Feature	feature to segment line by

Example

1var line = {
2  "type": "Feature",
3  "properties": {},
4  "geometry": {
5    "type": "LineString",
6    "coordinates": [
7      [
8        -24.78515625,
9        2.7235830833483856
10      ],
11      [
12        -22.8515625,
13        2.1967272417616712
14      ],
15      [
16        -20.390625,
17        5.003394345022162
18      ],
19      [
20        -18.984375,
21        2.6357885741666065
22      ],
23      [
24        -14.94140625,
25        4.8282597468669755
26      ],
27      [
28        -11.337890625,
29        7.536764322084078
30      ],
31      [
32        -9.052734375,
33        3.601142320158722
34      ],
35      [
36        -6.328125,
37        0.3515602939922709
38      ]
39    ]
40  }
41};
42
43var poly = {
44  "type": "Feature",
45  "properties": {},
46  "geometry": {
47    "type": "Polygon",
48    "coordinates": [
49      [
50        [
51          -20.91796875,
52          9.882275493429953
53        ],
54        [
55          -22.67578125,
56          6.926426847059551
57        ],
58        [
59          -21.005859375,
60          1.6696855009865839
61        ],
62        [
63          -18.45703125,
64          5.090944175033399
65        ],
66        [
67          -16.083984375,
68          1.845383988573187
69        ],
70        [
71          -13.798828125,
72          8.928487062665504
73        ],
74        [
75          -20.91796875,
76          9.882275493429953
77        ]
78      ]
79    ]
80  }
81};
82
83var features = turf.featurecollection([line,poly])
84//=features
85
86var result = turf.lineSliceAtIntersection(line, poly);
87
88result.features.forEach(function(ft, ind) {
89  ft.properties.stroke = (ind % 2 === 0) ? '#f40' : '#389979';
90});
91
92//=result

Returns FeatureCollection.<LineString>, segmented lines

Installation

Requires nodejs.

1$ npm install turf-line-slice-at-intersection

Tests

1$ npm test