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.

Parameters

LabelExplanationData Type
Input 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 is — The current conflict prevention setting will be used. This is the default.
  • Enable — Conflict prevention will be enabled for the input LRS.
  • Disable — Conflict prevention will be disabled for the input LRS.
String

Derived Output

LabelExplanationData Type
Updated Input Workspace

The updated LRS workspace string.

Workspace

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})
NameExplanationData 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