This repository holds a collection of easy to use ArcGIS Geoprocessing scripts (10.3+ and Pro) intended to provide automated line editing routines to help create useful study geometries. The tools are described below.
-
Feature Line Split - create a new feature class that has input lines split into an arbitrary number of segments.
-
Feature Line Pull - create a new feature class that has input lines split pulled back a target length.
-
Feature Line Whiskers - create a new feature class that perpendicular lines generated based on the sampled headings of the input polylines.
-
Feature Line Corridor Assembly - will add corridor ids to an output line network for all lines that are parallel within a tolerance and spatially connected/contiguous.
-
Feature Line Roll - Will extend a polyline based on the sampling of the line near its end points.
If you use the tool in academic research or as part of professional reports, please cite the tool as the following:
Wasserman, D. Study Line Editor. (2019) GitHub repository, GitHub https://github.com/d-wasserman/study-line-editor.
It is polite to cite.
In depth descriptions, are provided below.
Summary
This scripting tool will take an input feature line, and split its line features into the number of target segments or target distance specified by the target specified by the input integer or input field. Each line feature will be split into the number of segments specified. This version of the script will carry over any of the fields of the original feature class using cursors, it will only split the geometry into equal length segments for a number of segments for each line equal to the target count.
Usage
The goal of this script was to split target line features into (such as routes or paths) for all the line features in a feature layer, into segments of a target length or split equally into a target segment count similar to many of the proportional editing tools. The intended uses for this are:
-
Aid in the creation of study segments to summarize data on for linear networks.
-
Aid in the creation of animations for routes by allowing the creation equal length converging line segments whose ends can be converted to points.
-
Provide a tool for batch editing and segmentation of polylines.
Works in ArcGIS Pro (2to3 compatible)
Parameters
| Parameter | Explanation | Data Type |
|---|---|---|
| Input_Feature_Line |
Dialog Reference This is the input feature class whose individual geometry features will be broken into the number of desired target segments and put into a new feature class. The input can only be a polyline for this tool, because it uses Polyline specific methods. ___________________ Python Reference This tool depends on the segmentAlongLine method in ArcGIS 10.3. |
Feature Layer |
| Segmentation_Number |
Dialog Reference This is either the target number of segments for the output lines or the target length in the units of the current projection of the segments for the output lines depending on the split method. There is no python reference for this parameter. |
Long |
| Segmentation_Field (Optional) |
Dialog Reference This is a field that denotes the target number of segments for the output lines or the target length in the units of the current projection of the segments for the output lines depending on the split method. If a field is chosen it will override the segmentation number parameter. There is no python reference for this parameter. |
Field |
| Split_Method |
Dialog Reference This parameter denotes how the input lines will be split. Length will use the current projection's linear units and the chosen segmentation field or value to split the input lines into segments of the chosen length (or close to the chosen length if Best Fit is True). Segment Count will break the lines into segments of equal length based on the segment count. There is no python reference for this parameter. |
String |
| Best_Fit_Line |
Dialog Reference If True and Length is the split method, the lines will be split into segments of length closest to the target determined by the value or field while not creating short end segments. It will result in lines closest to the target length but maintain lines of equal length in the output. There is no python reference for this parameter. |
Boolean |
| Overlap Percentage |
Dialog Reference A target percentage to overlap split lines by. If set to 50% for example, lines split will overlap by 50% of their length across other split lines. There is no python reference for this parameter. |
Boolean |
| Output_Feature_Line |
Dialog Reference This is the output polyline feature class that will be created by this tool. It should have the fields of the original feature class derived by an insert cursor. ___________________ Python Reference Uses insert cursors to get the desired "copy" of the segmented feature class. |
Feature Class |
Summary
This scripting tool will take an input feature line, and remove a target amount of length from the ends of the lines (pulling them back). Each line feature will be copied once. This version of the script will carry over any of the fields of the original feature class using cursors, it will only return pulled back geometries in the new feature class.
Usage
The goal of this script was to split target line features into (such as routes or paths) for all the line features in a feature layer, into segments that are pulled back a target amount. The intended uses for this are:
-
Aid in the creation of study segments to summarize data on for networks.
-
Allow proximity analysis for point features that do not include intersections/target nodes.
-
Provide a tool for batch editing and segmentation of polylines.
Works in ArcGIS Pro (2to3 compatible)
Parameters
| Parameter | Explanation | Data Type |
|---|---|---|
| Input_Feature_Line |
Dialog Reference This is the input feature class whose individual geometry features will be pulled back and put into a new feature class. The input can only be a polyline for this tool, because it uses Polyline specific methods. ___________________ Python Reference This tool depends on the segmentAlongLine method in ArcGIS 10.3. |
Feature Layer |
| Pull_Amount |
Dialog Reference The distance in units of the current projection, that you wish your line features to be pulled back. There is no python reference for this parameter. |
Long |
| Pull_Field (Optional) |
Dialog Reference A Field using a distance in units of the current projection, that specifies the amount you wish your line features to be pulled back. There is no python reference for this parameter. |
Field |
| Start_Point_Pull |
Dialog Reference Determines whether the line has a distance starting at the line start point is pulled back. There is no python reference for this parameter. |
String |
| End_Point_Pull |
Dialog Reference Determines whether the line has a distance ending at the line end point is pulled back. There is no python reference for this parameter. |
Boolean |
| Output_Feature_Line |
Dialog Reference This is the output polyline feature class that will be created by this tool. It should have the fields of the original feature class derived by an insert cursor. ___________________ Python Reference Uses insert cursors to get the desired "copy" of the segmented feature class. |
Feature Class |
Summary
This scripting tool is intended to assist with tasks related to createing intelligence related to right of way widths from vector polygons such as building footprints (distance to frontage), road bed polygons, or sidewalk trace polygons found by remote sensing/computer vision/deep learning techniques. This tools main purpose is to create whiskers that are perpendicular to the line being used to create them. Once these whiskers are made, they can be trimmed by arbitrary polygons (feature to line), and then used to determine the widths of various features. This is a tool that is intended to generalize to many transportation/urban planning workflows.
Usage
The goal of this script was to create whiskers (like cat whiskers), that can be used to create lines that are perpendicular to an input sample line. The intended uses for this are:
-
Aid in determining right of way widths from roadbed polygons/sidewalk polygons.
-
Determine the distance of a road from features perpendicular to their centroids.
Works in ArcGIS Pro (2to3 compatible)
Parameters
| Parameter | Explanation | Data Type |
|---|---|---|
| Input_Feature_Line |
Dialog Reference This is the input feature class whose individual geometry features will be pulled back and put into a new feature class. The input can only be a polyline for this tool, because it uses Polyline specific methods. ___________________ Python Reference This tool depends on the segmentAlongLine method in ArcGIS 10.3. |
Feature Layer |
| Whisker_Width |
Dialog Reference This is the target width of the whisker that will be generated from the input polyline. If a field is chosen, this attribute is ignored. There is no python reference for this parameter. |
Long |
| Whisker_Field (Optional) |
Dialog Reference Allows you to choose a field that determines the width of the whisker generated on the target polylines. There is no python reference for this parameter. |
Field |
| Sample_Length |
Dialog Reference This is likely the most complex attribute to explain. If this is not set, or is zero, the heading from the line is determined by by the start and end points of the line. This attribute allows you to create a new line that is near the center of the line that has a much smaller size. The sample line will not be seen, but this attribute determines the length sampled from the center of the line to determine heading. There is no python reference for this parameter. |
Double |
| Output_Feature_Line |
Dialog Reference This is the output polyline feature class that will be created by this tool. It should have the fields of the original feature class derived by an insert cursor. ___________________ Python Reference Whiskers should be perpendicular to the input line. |
Feature Class |
Summary
This tool will construct a near table to construct a relationship table between lines. It will using the bearing of lines and their corresponding relationships to generate corridor ids consisting of all parallel line features within the threshold that are connected to each other.
Usage
This tool will construct a near table to construct a relationship table between lines. It will using the bearing of lines and their corresponding relationships to generate corridor ids consisting of all parallel line features within the threshold that are connected to each other. The intended uses for this are:
-
Aid in the creation of study segments to summarize data on for linear networks.
-
Provide a tool to generate corridors for study and data summarization that does not depend on arbitrary street names or functional class attributes.
-
Provide a tool for batch editing and segmentation of polylines.
Works in ArcGIS Pro (2to3 compatible). This tool requires the pandas library to work.
Parameters
| Parameter | Explanation | Data Type |
|---|---|---|
| Input_Feature_Line |
Dialog Reference This is the input feature class whose individual geometry will be used to assemble corridors from parallel connected lines. ___________________ Python Reference This tool depends on the pandas Python Library. |
Feature Layer |
| Output_Feature_Line |
Dialog Reference This output line feature class of the tool is a copy of the input network with line statistics and corridor attributes added. The fields added include: "Azimuth", "Link_Cnt", "Min_Link_Angle", "Max_Link_Angle", "Mean_Link_Angle", "Parallel_Present", "Corridor_ID" There is no python reference for this parameter. |
Long |
| Connected_Range |
Dialog Reference This represents the distance between connected line segments. If lines are directly connected this should be a very small number. There is no python reference for this parameter. |
Field |
| Parallel_Threshold |
Dialog Reference The threshold of angles in degrees between parallel lines and non-parallel lines. There is no python reference for this parameter. |
String |
Summary
This tool will take an input feature line and extend its end points based on the angle implied by a sample of its start and end points. This enables the output line features to maintain the original attributes, but be extended in both directions to enable rolling linear statistics.
Usage
The goal of this script is to enable linear rolling windows through the extensions of segments in a line feature class. The intended uses for this are:
-
Aid in the creation of rolling window segments for linear rolling stats.
-
Allow proximity analysis for point features that blend intersections.
-
Provide a tool to assist with Vision Zero and related safety analysis.
Works in ArcGIS Pro. This tool requires the pandas library to work.
Parameters
| Parameter | Explanation | Data Type |
|---|---|---|
| Input Feature Line |
Dialog Reference The input feature class whose extends will be extended based on some determined distance in the current projection. ___________________ Python Reference This tool depends on the pandas Python Library. |
Feature Layer |
| Extension Distance |
Dialog Reference The extension distance in the units of the current projection to extend the line. There is no python reference for this parameter. |
Long |
| End Sampling Percentage |
Dialog Reference The percentage of the ends of the polyline to use for bearing calculations informing the extension. Expressed as a ratio. There is no python reference for this parameter. |
Float |
| Output Feature Line |
Dialog Reference This is the output polyline feature class that will be created by this tool with extended lines. It should have the fields of the original feature class derived by an insert cursor. There is no python reference for this parameter. |
String |