Available with Location Referencing license.
The following information guides you through the process of linear referenced data modeling, loading, and route editing using the ArcGIS Roads and Highways extension.
LRS dataset
A linear referencing system (LRS) dataset is a controller dataset in a feature dataset in the geodatabase along with all the feature classes that participate in the LRS.
Note:
You can view the LRS hierarchy from either the Contents or Catalog panes.
Note:
The LRS dataset is visible only in ArcGIS Pro. An error message appears if a geodatabase that contains the LRS dataset is opened in ArcMap.
The following tools create an LRS dataset, as of ArcGIS Pro 2.3:
The LRS dataset is required to run the following tools:
You can review some of the information contained in the LRS dataset using an arcpy.Describe function. To review the LRS Metadata and Event Behavior Rules for a geodatabase with an LRS controller dataset, use the following functions:
FileGDB:
desc = arcpy.Describe("C:\\Data\\LRData\\LrsSchema.gdb\\Lrs\\Lrs")
lrsXML = desc.lrsMetadata
eventBehaviors = desc.eventBehaviorRules
EnterpriseGDB:
desc = arcpy.Describe("C:\\Data\\LRData\\LrsSchema.sde\\GPRefresh.DBO.LRS\\GPRefresh.DBO.LRS")
lrsXML = desc.lrsMetadata
eventBehaviors = desc.eventBehaviorRules
Writing to a file:
txtFile = open("C:\\Data\\LRData\\lrsXML.xml", "w")
txtFile.write(lrsXML)
txtFile.close()
Data modeling
Transportation professionals are routinely tasked with considering alternative routing options to ensure regulatory compliance, market, construction, and other business needs. This usually results in realigning (rerouting) a roadway. Realignment not only changes the pathways of roads but also impacts networks and events configured in an LRS data model.
To use Roads and Highways, your data must be in the Roads and Highways information model in the geodatabase. For more information, refer to the following topics:
Configure an LRS
The modeling and creation of your linear referencing system (LRS) can be performed using the following tools.
- Create and modify an LRS.
You can use either the Create LRS or Create LRS From Existing Dataset tool to create an LRS.
To modify an existing LRS, use Modify LRS. This includes enabling conflict prevention in an LRS.
- Create LRS networks.
You can use either the Create LRS Network or Create LRS Network From Existing Dataset tool.
To modify an existing LRS Network, use the Modify LRS Network tool.
- Create LRS events.
You can use either the Create LRS Event or Create LRS From Existing Dataset tool.
To add referent fields to the event feature class, use Enable Referent Fields. This tool enables the referent fields by allowing you to register existing fields as referent fields.
To modify an existing LRS event, use Modify LRS Event.
- Create LRS intersections.
You can use either the Create LRS Intersection or Create LRS Intersection From Existing Dataset tool.
To add intersections to your intersection feature class, run the Generate Intersections tool.
To modify an existing LRS intersection feature class, use the Modify LRS Intersection tool.
- Load routes into the LRS Network.
Once the LRS is created, routes can be loaded using the Append Routes tool. Route shapes can be regenerated using the Generate Routes tool.
Learn more about how to load routes into an existing LRS Network
Learn more about setting gap calibration rules for an LRS Network
- Create calibration points.
To add calibration points, use the Generate Calibration Points and Append Routes tools.
Note:
If calibration points will be appended outside the Generate Calibration Points tool, this step should be completed before loading routes into the LRS Network.
- Prepare centerlines.
To remove overlaps that could cause data errors, use Remove Overlapping Centerlines.
- Load event data.
To load event records from a table, layer, or feature class into an existing event feature class, use Append Events.
Realign and reroute
The following tools are used to realign (reroute) and maintain linear referenced data:
- Create Centerline—Decide if one or more centerlines exist for the realignment portion of a route or routes.
- Event Behavior—Consider how event behavior rules can apply to your route edits.
- Apply Event Behaviors—Apply event behaviors to keep event measures in alignment with route edits.
- LRS Network—Decide if other LRS networks are affected by route edits.
- Generate Routes—Regenerate shapes for LRS networks.
Route editing workflows
Similar workflows can be created for other route editing activities such as create, extend, realign, reassign, retire, calibrate, and cartographic realignment.
The following table lists steps required to edit and maintain roadway data.
Step | Workflow | Create | Calibrate | Cartographic Realignment | Extend | Realign | Reassign | Retire |
---|---|---|---|---|---|---|---|---|
1 | Create a centerline. | Yes | No | No | Yes | No | No | No |
2 | Perform the editing activity. | Yes | Not applicable | Not applicable | Yes | Yes | Yes | Yes |
3 | Run the Apply Event Behaviors tool. | No | Yes | Yes | Yes | Yes | Yes | Yes |
If more LRS networks are configured, repeat the edit activity for each affected network.