Summary
Modifies an existing linear referencing system (LRS) in the specified workspace.
Usage
The Modify LRS tool can be used on a feature class or table with or without geometry or records.
The route ID and centerline ID must be unique; however, the tool does not check for duplicate IDs.
This tool does not check for erroneous network IDs; if the network ID does not exist, it is considered erroneous.
For more information about configuring the LRS and field properties, see the ArcGIS Pipeline Referencing LRS data model or the ArcGIS Roads and Highways LRS data model.
Syntax
arcpy.locref.ModifyLRS(in_workspace, current_lrs_name, {new_lrs_name}, {centerline_feature_class}, {centerline_centerline_id_field}, {centerline_sequence_table}, {centerline_sequence_centerline_id_field}, {centerline_sequence_route_id_field}, {centerline_sequence_from_date_field}, {centerline_sequence_to_date_field}, {centerline_sequence_network_id_field}, {calibration_point_feature_class}, {calibration_point_measure_field}, {calibration_point_from_date_field}, {calibration_point_to_date_field}, {calibration_point_route_id_field}, {calibration_point_network_id_field}, {redline_feature_class}, {redline_from_measure_field}, {redline_to_measure_field}, {redline_route_id_field}, {redline_route_name_field}, {redline_effective_date_field}, {redline_activity_type_field}, {redline_network_id_field}, {conflict_prevention})| Parameter | Explanation | Data Type |
in_workspace | The LRS workspace. | Workspace |
current_lrs_name | The name of the current LRS. | String |
new_lrs_name (Optional) | The new name of the current LRS. | String |
centerline_feature_class (Optional) | An existing centerline feature class for the minimum schema. | Feature Layer |
centerline_centerline_id_field (Optional) | The name of the centerline ID field from the existing centerline feature class that was chosen. | Field |
centerline_sequence_table (Optional) | An existing centerline sequence table for the minimum schema. | Table View |
centerline_sequence_centerline_id_field (Optional) | The name of the centerline ID field from the existing centerline sequence table that was chosen. | Field |
centerline_sequence_route_id_field (Optional) | The name of the route ID field from the existing centerline sequence table that was chosen. | Field |
centerline_sequence_from_date_field (Optional) | The name of the from date field from the existing centerline sequence table that was chosen. | Field |
centerline_sequence_to_date_field (Optional) | The name of the to date field from the existing centerline sequence table that was chosen. | Field |
centerline_sequence_network_id_field (Optional) | The name of the network ID field from the existing centerline sequence table that was chosen. | Field |
calibration_point_feature_class (Optional) | An existing calibration point feature class for the minimum schema. | Feature Layer |
calibration_point_measure_field (Optional) | The name of the measure field from the existing calibration point feature class that was chosen. | Field |
calibration_point_from_date_field (Optional) | The name of the from date field from the existing calibration point feature class that was chosen. | Field |
calibration_point_to_date_field (Optional) | The name of the to date field from the existing calibration point feature class that was chosen. | Field |
calibration_point_route_id_field (Optional) | The name of the route ID field from the existing calibration point feature class that was chosen. | Field |
calibration_point_network_id_field (Optional) | The name of the network ID field from the existing calibration point feature class that was chosen. | Field |
redline_feature_class (Optional) | An existing redline feature class for the minimum schema. | Feature Layer |
redline_from_measure_field (Optional) | The name of the from measure field from the existing redline feature class that was chosen. | Field |
redline_to_measure_field (Optional) | The name of the to measure field from the existing redline feature class that was chosen. | Field |
redline_route_id_field (Optional) | The name of the route ID field from the existing redline feature class that was chosen. | Field |
redline_route_name_field (Optional) | The name of the route name field from the existing redline feature class that was chosen. | Field |
redline_effective_date_field (Optional) | The name of the effective date field from the existing redline feature class that was chosen. | Field |
redline_activity_type_field (Optional) | The name of the activity type field from the existing redline feature class that was chosen. | Field |
redline_network_id_field (Optional) | The name of the network ID field from the existing redline feature class that was chosen. | Field |
conflict_prevention (Optional) | Specifies whether conflict prevention will be enabled for the input LRS. Conflict prevention is only available when editing or performing geoprocessing on branch versioned data that is published as a feature service.
| String |
Derived Output
| Name | Explanation | Data Type |
| out_workspace | The updated LRS workspace string. | Workspace |
Code sample
The following script demonstrates how to use the ModifyLRS function in the Python window.
# tool variables
input_workspace = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb"
current_lrs_name = "LRS1"
new_lrs_name = "NewLRS"
centerline_feature_class = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\centerline1"
centerline_centerline_ID_field = "centerlineId"
centerline_sequence_table = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\centerline_Sequence1"
centerline_sequence_centerline_id_field = "centerlineId"
centerline_sequence_route_id_field = "RouteId"
centerline_sequence_from_date_field = "FromDate"
centerline_sequence_to_date_field = "ToDate"
centerline_sequence_network_ID_field = "NetworkId"
calibration_point_feature_class = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\calibration_Point1"
calibration_point_measure_field = "Measure"
calibration_point_from_date_field = "FromDate"
calibration_point_to_date_field = "ToDate"
calibration_point_route_id_field = "RouteId"
calibration_point_network_ID_field = "NetworkId"
redline_feature_class = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\Redline1"
redline_from_measure_field = "FromMeasure"
redline_to_measure_field = "ToMeasure"
redline_route_id_field = "RouteId"
redline_route_name_field = "RouteName"
redline_effective_date_field = "EffectiveDate"
redline_activity_type_field = "ActivityType"
redline_network_id_field = "NetworkId"
# set current workspace
arcpy.env.workspace = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb"
# execute the tool
arcpy.ModifyLRS_locref(in_workspace, current_lrs_name, new_lrs_name, centerline_feature_class, centerline_centerline_id_field, centerline_sequence_table, centerline_sequence_centerline_id_field, centerline_sequence_route_id_field, centerline_sequence_from_date_field, centerline_sequence_to_date_field, centerline_sequence_network_id_field, calibration_point_feature_class, calibration_point_measure_field, calibration_point_from_date_field, calibration_point_to_date_field, calibration_point_route_id_field, calibration_point_network_id_field, redline_feature_class, redline_from_measure_field, redline_to_measure_field, redline_route_id_field, redline_route_name_field, redline_effective_date_field, redline_activity_type_field, redline_network_id_field)The following script demonstrates how to use the ModifyLRS function in a stand-alone Python script.
# Name: Modify_LRS_ex2.py
# Description: Modifies existing LRS configuration based on the new parameters provided
# Requires: ArcGIS Pipeline Referencing
# Import arcpy module
import arcpy
# check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")
# Local variables:
input_workspace = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb"
current_lrs_name = "LRS1"
new_lrs_name = "NewLRS"
centerline_feature_class = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\centerline1"
centerline_centerline_ID_field = "centerlineId"
centerline_sequence_table = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\centerline_Sequence1"
centerline_sequence_centerline_id_field = "centerlineId"
centerline_sequence_route_id_field = "RouteId"
centerline_sequence_from_date_field = "FromDate"
centerline_sequence_to_date_field = "ToDate"
centerline_sequence_network_ID_field = "NetworkId"
calibration_point_feature_class = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\calibration_Point1"
calibration_point_measure_field = "Measure"
calibration_point_from_date_field = "FromDate"
calibration_point_to_date_field = "ToDate"
calibration_point_route_id_field = "RouteId"
calibration_point_network_ID_field = "NetworkId"
redline_feature_class = r"c:\ModifyLRS\Py\ModifyLRS_python.gdb\Redline1"
redline_from_measure_field = "FromMeasure"
redline_to_measure_field = "ToMeasure"
redline_route_id_field = "RouteId"
redline_route_name_field = "RouteName"
redline_effective_date_field = "EffectiveDate"
redline_activity_type_field = "ActivityType"
redline_network_id_field = "NetworkId"
# execute the tool
arcpy.ModifyLRS_locref(in_workspace, current_lrs_name, new_lrs_name, centerline_feature_class, centerline_centerline_id_field, centerline_sequence_table, centerline_sequence_centerline_id_field, centerline_sequence_route_id_field, centerline_sequence_from_date_field, centerline_sequence_to_date_field, centerline_sequence_network_id_field, calibration_point_feature_class, calibration_point_measure_field, calibration_point_from_date_field, calibration_point_to_date_field, calibration_point_route_id_field, calibration_point_network_id_field, redline_feature_class, redline_from_measure_field, redline_to_measure_field, redline_route_id_field, redline_route_name_field, redline_effective_date_field, redline_activity_type_field, redline_network_id_field)Environments
Licensing information
- Basic: Requires ArcGIS Location Referencing
- Standard: Requires ArcGIS Location Referencing
- Advanced: Requires ArcGIS Location Referencing