Create LRS From Existing Dataset (Location Referencing)

Summary

Creates a linear referencing system (LRS) in the specified workspace using existing datasets.

Usage

  • Minimum schema items are used for the centerline, centerline sequence, calibration point, and redline feature classes. They should be contained in the same geodatabase, should not be used by another LRS in the geodatabase, and should be empty.

  • Centerline, calibration point, and redline feature classes must reside in a feature dataset.

  • The spatial reference, tolerance, and resolution of the centerline, calibration points, and redline feature classes should be the same.

  • The centerline and calibration point feature classes should be z-enabled and can be m-enabled.

  • The redline feature class should not be z- or m-enabled.

Syntax

arcpy.locref.CreateLRSFromExistingDataset(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
lrs_name

The name of the LRS to create. The name for the LRS cannot already exist in the geodatabase.

String
centerline_feature_class

The feature class to be used as the centerline in the LRS.

Feature Layer
centerline_centerline_id_field

The GUID field containing the centerline ID. The field type must match the centerlineID field type in the centerline sequence table.

Field
centerline_sequence_table

The table to be used as the centerline sequence in the LRS.

Table View
centerline_sequence_centerline_id_field

The GUID field containing the centerline sequence ID. The field type must match the centerlineID field type and length in the centerline feature class.

Field
centerline_sequence_route_id_field

The GUID or text field containing the centerline sequence route ID. The field type must match the routeID field type and length in the calibration point and redline feature classes.

Field
centerline_sequence_from_date_field

A date field containing the centerline sequence from date.

Field
centerline_sequence_to_date_field

A date field containing the centerline sequence to date.

Field
centerline_sequence_network_id_field

The field containing the centerline sequence network ID. The short integer field type is supported.

Field
calibration_point_feature_class

The feature class to be used as the calibration point in the LRS.

Feature Layer
calibration_point_measure_field

The field containing the calibration point measure. The double field type is supported.

Field
calibration_point_from_date_field

A date field containing the calibration point from date.

Field
calibration_point_to_date_field

A date field containing the calibration point to date.

Field
calibration_point_route_id_field

The field containing the calibration point route ID. GUID and text field types are supported. The field type must match the routeID field type and length in the centerline sequence table and Redline feature class.

Field
calibration_point_network_id_field

The field containing the calibration point network ID. The short integer field type is supported.

Field
redline_feature_class

The feature class to be used as the redline in the LRS.

Feature Layer
redline_from_measure_field

The field containing the redline from measure. The double field type is supported.

Field
redline_to_measure_field

The field containing the redline to measure. The double field type is supported.

Field
redline_route_id_field

The field containing the redline route ID. GUID and text field types are supported. The field type must match the routeID field type and length in the calibration point feature class and centerline sequence table.

Field
redline_route_name_field

A text field containing the redline route name.

Field
redline_effective_date_field

A date field containing the redline effective date.

Field
redline_activity_type_field

The field containing the redline activity type. The short integer field type is supported.

Field
redline_network_id_field

The field containing the redline network ID. The short integer field type is supported.

Field

Derived Output

NameExplanationData Type
out_path

The path of the newly created LRS Network.

Workspace

Code sample

CreateLRSFromExistingDataset example 1 (Python window)

This script creates an LRS with existing minimum schema items using the CreateLRSFromExistingDataset function in the Python window.

# Name: Create_LRS_Existing_Dataset_ex1.py
# Description: Create an LRS using existing minimum schema items (Centerline, Centerline Sequence, Calibration Point, Redline) in a file or multiuser geodatabase.
# Requires: ArcGIS Location Referencing

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Tool variables
lrs_name = "LRS"
centerline_feature_class = r"C:\Data\PipelineData.sde\LRS\Centerline"
centerline_centerline_id_field = "Centerline_ID"
centerline_sequence_table = r"C:\Data\PipelineData.gdb\CenterlineSequence"
centerline_sequence_centerline_id_field = "Centerline_ID"
centerline_sequence_route_id_field = "Route_ID"
centerline_sequence_from_date_field = "From_Date"
centerline_sequence_to_date_field = "To_Date"
centerline_sequence_network_id_field = "Network_ID"
calibration_point_feature_class = r"C:\Data\PipelineData.gdb\LRS\CalibrationPoint"
calibration_point_measure_field = "Measure"
calibration_point_from_date_field = "From_Date"
calibration_point_to_date_field = "To_Date"
calibration_point_route_id_field = "Route_ID"
calibration_point_network_id_field = "Network_ID"
redline_feature_class = r"C:\Data\PipelineData.gdb\LRS\Redline"
redline_from_measure_field = "From_Measure"
redline_to_measure_field = "To_Measure"
redline_route_id_field = "Route_ID"
redline_route_name_field = "Route_Name"
redline_effective_date_field = "Effective_Date"
redline_activity_type_field = "Activity_Type"
redline_network_id_field = "Network_ID"

# Set current workspace
arcpy.env.workspace = "C:\Data\PipelineData.sde"

# Execute the tool
arcpy.CreateLRSFromExistingDataset_locref(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)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
CreateLRSFromExistingDataset example 2 (stand-alone script)

This script creates an LRS with existing minimum schema items using the CreateLRSFromExistingDataset function in a stand-alone Python script.

# Name: Create_LRS_Existing_Dataset_ex2.py
# Description: Create an LRS using existing minimum schema items (Centerline, Centerline Sequence, Calibration Point, Redline) in a file or multiuser geodatabase.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables
lrs_name = "LRS"
centerline_feature_class = r"C:\Data\PipelineData.gdb\LRS\Centerline"
centerline_centerline_id_field = "CenterlineID"
centerline_sequence_table = r"C:\Data\PipelineData.gdb\CenterlineSequence"
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:\DataPipelineData.gdb\LRS\CalibrationPoint"
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:\DataPipelineData.gdb\LRS\CalibrationPoint"
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.CreateLRSFromExistingDataset_locref(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)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

Environments

Licensing information

  • Basic: Requires ArcGIS Location Referencing
  • Standard: Requires ArcGIS Location Referencing
  • Advanced: Requires ArcGIS Location Referencing

Related topics