Modify LRS (Location Referencing)

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})
ParameterExplanationData 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.

  • AS_ISThe current conflict prevention setting will be used. This is the default.
  • ENABLEConflict prevention will be enabled for the input LRS.
  • DISABLEConflict prevention will be disabled for the input LRS.
String

Derived Output

NameExplanationData Type
out_workspace

The updated LRS workspace string.

Workspace

Code sample

ModifyLRS example 1 (Python window)

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)
ModifyLRS example 2 (stand-alone script)

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

Related topics