Update Measures From LRS (Location Referencing Tools)

Summary

Populates or updates the route and measure attributes on any point or line features, including Utility Network features such as pipes, devices, and junctions, or LRS features such as events and intersections.

The attributes that will be updated include route ID, route name (if configured), and measures.

Usage

• This tool supports data from a file geodatabase, an enterprise geodatabase (branch versioned connection), or a feature service (published from branch versioned data).

• The spatial reference, x,y resolution, and x,y tolerance of the Input Features and LRS Network parameter values must match.

• The To Route ID Field and To Route Name Field parameters are optional and are applicable for features that span routes.

• The Search Tolerance parameter is used to update the route and measure attributes of the input features if they are not coincident with a route.

  • The nearest route's route and measure available within the search tolerance will be used to update the input features.

  • If two or more routes are equidistant from an input feature, any one of those routes will be used for the update.

  • If the input feature is a line feature, the route and measure attributes will be populated only when the start and end of the line feature are within the search tolerance of a route.

• The following diagrams and tables show how point and line input features will be updated:

  

  Updated route and measure attributes in the input layer

  Feature Type	Route ID	From Measure	To Measure	Comments
  Line	Route1	11	17	The line feature's geometry has a geometric match with Route1.

  

  Updated route and measure attributes in the input layer

  Feature Type	Route ID	Measure	Comments
  Point	Route1	21	The point feature is on Route1.

  

  Updated route and measure attributes in the input layer

  Feature Type	Route ID	Measure	Comments
  Point	Route1	21	The point feature is not on Route1. By providing a search tolerance, the route and measure attributes are updated from the nearest route.

  

  Updated route and measure attributes in the input layer

  Feature Type	Route ID	Route Name	From Measure	To Route ID	To Route Name	To Measure	Comments
  Line	Route1	L1R1	11	Route2	L1R2	28	The line feature's geometry has a geometric match with routes L1R1 and L1R2, which belong to the same line.

Parameters

• Dialog
• Python

Label	Explanation	Data type
LRS Network	The feature layer that contains the routes, route IDs, route names (if configured), and measures.	Feature Layer
LRS Date	The date that will be used to define the temporal view of the network.	Date
Input Features	The point or line features that will be updated based on feature geometry relative to the routes in the LRS Network.	Feature Layer
Route ID Field	The field in the Input Features parameter value that contains the route ID attribute. The data type and length of the field must match those of the corresponding field in the LRS Network.	Field
Measure Field	The field in the Input Features parameter value that contains the measure value for point features or the start measure value for line features. The data type and length of the field must match those of the corresponding field in the LRS Network.	Field
To Measure Field (Optional)	The field in the Input Features parameter value that contains the end measure value for line features. The data type and length of the field must match those of the corresponding field in the LRS Network.	Field
To Route ID Field (Optional)	The field in the Input Features parameter value that contains the to route ID attribute. This parameter is only available when the Input Features parameter value is a line feature layer. The data type and length of the field must match those of the corresponding field in the LRS Network.	Field
Route Name Field (Optional)	The field in the Input Features parameter value that contains the route name attribute. This parameter is only available when the LRS Network has a route name configured. The data type and length of the field must match those of the corresponding field in the LRS Network.	Field
To Route Name Field (Optional)	The field in the Input Features parameter value that contains the to route name attribute. This parameter is only available when the LRS Network has a route name configured and the Input Features parameter value is a line feature layer. The data type and length of the field must match those of the corresponding field in the LRS Network.	Field
Search Tolerance (Optional)	The routes that are within the search tolerance of the input feature will be identified. The nearest route's route and measure available within the search tolerance will be used to update the input features. The search tolerance unit is based on the x,y unit of the LRS Network.	Double

Derived output

Label	Explanation	Data type
Output Details File	The output .csv file that lists the updated input features. This .csv file includes the route ID, route name (if configured), and measure attributes of each updated feature before and after the update.	File
Out Features	The updated feature layer. Note: Validation results for this tool are written to the ArcGIS Server directory. This file is automatically cleaned up in 10 minutes by default, which may not be enough time to process all of the validations and write them to your workstation that is running ArcGIS Pro. For larger data loads, it is recommended that you adjust the maximum file age to at least one hour.	Feature Layer

Environments

Current Workspace

Licensing information

• Basic: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
• Standard: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
• Advanced: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)

Related topics

• An overview of the Location Referencing toolbox
• Find a geoprocessing tool