Create Routes (Linear Referencing)

ArcGIS Pro 3.4 | | Help archive

Summary

Creates routes from existing lines. The input line features that share a common identifier are merged to create a single route.

Usage

  • The unique values in the Route Identifier Field parameter value are written to the Output Route Feature Class.

  • Use the Make Feature Layer or Make Query Table tools to reduce the number of lines that will be used to create routes.

  • If the Output Route Feature Class parameter value will be written to a geodatabase, set the appropriate M Tolerance, M Resolution, and M Domain environments.

  • Use the Measure Factor parameter to convert between route measure units. For example, to convert from feet to miles, use a factor of 0.00018939394.

  • Use the Measure Offset parameter value in applications where the start measure of each route must be a value other than 0.

  • The Ignore spatial gaps parameter is not used when the Measure Source parameter is specified as Values from two fields . This is because measure values are based on the From-Measure Field and To-Measure Field parameter values.

  • When the Measure Source parameter is specified as Length of features or Values from a single field, the Coordinate Priority parameter value is determined by placing the minimum bounding rectangle around the input features that will be merged to create one route.

  • When the Measure Source parameter is specified as Values from two fields, it is not necessary to specify a coordinate priority because measure direction is implied by the values in the From-Measure Field and the To-Measure Field parameters.

  • An attribute index on the route identifier field speeds up the dynamic segmentation process. If you will be using the Output Route Feature Class parameter value for dynamic segmentation, it is recommended that you create an attribute index.

  • If any features are rejected by the this tool, a text file is created in the temporary file path to store information about those features; For example, C:\Users\patrickb\AppData\Local\Temp\Create_Output0.txt (in which Create_Output is the name of the output route feature class).

  • The Output has M Values environment setting will be ignored. The Output Route Feature Class parameter value will have m-values (measure values).

Parameters

LabelExplanationData Type
Input Line Features

The features from which routes will be created.

Feature Layer
Route Identifier Field

The field containing values that uniquely identify each route. The field can be a numeric, text, or GUID field.

Field
Output Route Feature Class

The feature class that will be created. It can be a shapefile or a geodatabase feature class.

Feature Class
Measure Source

Specifies how route measures will be accumulated.

  • Length of featuresThe geometric length of the input features will be used to accumulate the measures. This is the default.
  • Values from a single fieldThe value stored in a single field will be used to accumulate the measures.
  • Values from two fieldsThe values stored in both the from- and to-measure fields will be used to accumulate the measures.
String
From-Measure Field
(Optional)

A field containing measure values. This field must be numeric and is required when the measure source is Values from a single field or Values from two fields.

Field
To-Measure Field
(Optional)

A field containing measure values. This field must be numeric and is required when the measure source is Values from two fields.

Field
Coordinate Priority
(Optional)

The position from which measures will be accumulated for each output route. This parameter is ignored when the measure source is Values from two fields.

  • Upper left cornerMeasures will be accumulated from the point closest to the minimum bounding rectangle's upper left corner. This is the default.
  • Lower left cornerMeasures will be accumulated from the point closest to the minimum bounding rectangle's lower left corner.
  • Upper right cornerMeasures will be accumulated from the point closest to the minimum bounding rectangle's upper right corner.
  • Lower right cornerMeasures will be accumulated from the point closest to the minimum bounding rectangle's lower right corner.
String
Measure Factor
(Optional)

A value multiplied by the measure length of each input line before they are merged to create route measures. The default is 1.

Double
Measure Offset
(Optional)

A value added to the route measures after the input lines have been merged to create a route. The default is 0.

Double
Ignore spatial gaps
(Optional)

Specifies whether spatial gaps will be ignored when calculating the measures on disjointed routes. This parameter is applicable when the measure source is Length of features or Values from a single field.

  • Checked—Spatial gaps will be ignored. Measure values will be continuous for disjointed routes. This is the default.
  • Unchecked—Spatial gaps will not be ignored. The measure values on disjointed routes will have gaps. The gap distance is calculated using the straight-line distance between the endpoints of the disjointed parts.
Boolean
Build index
(Optional)

Specifies whether an attribute index will be created for the route identifier field that is written to the output route feature class.

  • Checked—An attribute index will be created. This is the default.
  • Unchecked—An attribute index will not be created.
Boolean

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics