Skip To Content

Modify LRS

Summary

Modifies an existing linear referencing system (LRS) in the specified workspace.

Usage

  • This tool can be used on a feature class or table with or without geometry and/or records.

  • The route ID and centerline ID must be unique; however, this tool will 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.

  • See details on configuring LRS and field properties for the ALRS data model.

Syntax

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})
ParameterExplanationData Type
in_workspace

The LRS workspace.

Workspace
current_lrs_name

Name of the current LRS.

String
new_lrs_name
(Optional)

New name for the current LRS.

String
centerline_feature_class
(Optional)

An existing centerline feature class for the minimum schema.

Feature Layer
centerline_centerline_id_field
(Optional)

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)

Name of the centerline ID field from the existing centerline sequence table that was chosen.

Field
centerline_sequence_route_id_field
(Optional)

Name of the route ID field from the existing centerline sequence table that was chosen.

Field
centerline_sequence_from_date_field
(Optional)

Name of the from date field from the existing centerline sequence table that was chosen.

Field
centerline_sequence_to_date_field
(Optional)

Name of the to date field from the existing centerline sequence table that was chosen.

Field
centerline_sequence_network_id_field
(Optional)

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)

Name of the measure field from the existing calibration point feature class that was chosen.

Field
calibration_point_from_date_field
(Optional)

Name of the from date field from the existing calibration point feature class that was chosen.

Field
calibration_point_to_date_field
(Optional)

Name of the to date field from the existing calibration point feature class that was chosen.

Field
calibration_point_route_id_field
(Optional)

Name of the route ID field from the existing calibration point feature class that was chosen.

Field
calibration_point_network_id_field
(Optional)

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)

Name of the from measure field from the existing redline feature class that was chosen.

Field
redline_to_measure_field
(Optional)

Name of the to measure field from the existing redline feature class that was chosen.

Field
redline_route_id_field
(Optional)

Name of the route ID field from the existing redline feature class that was chosen.

Field
redline_route_name_field
(Optional)

Name of the route name field from the existing chosen redline feature class that was chosen.

Field
redline_effective_date_field
(Optional)

Name of the effective date field from the existing redline feature class that was chosen.

Field
redline_activity_type_field
(Optional)

Name of the activity type field from the existing redline feature class that was chosen.

Field
redline_network_id_field
(Optional)

Name of the network ID field from the existing redline feature class that was chosen.

Field

Code sample

ModifyLRS example 1 (Python window)

The following Python window script demonstrates how to use the ModifyLRS tool in immediate mode.

# 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 tool 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

This tool does not use any geoprocessing environments.

Licensing information

  • ArcGIS Desktop Basic: Requires ArcGIS Pipeline Referencing
  • ArcGIS Desktop Standard: Requires ArcGIS Pipeline Referencing
  • ArcGIS Desktop Advanced: Requires ArcGIS Pipeline Referencing

Related topics