Create LRS (Location Referencing)

Summary

Creates an ArcGIS Location Referencing linear referencing system (LRS) and minimum schema items in a specified workspace.

Usage

• The minimum schema items created are the Centerline, Centerline Sequence, Calibration Point, and Redline feature classes.

• The names for the LRS, centerline, calibration point, redline, and centerline sequence must be unique and cannot already exist in the geodatabase.

• The spatial reference, tolerance, and resolution inputs will be applied to all output feature classes.

• If the input location is a feature dataset, the spatial reference, tolerance, and resolution of the feature dataset must match that of the inputs for the tool.

• The x,y- and z-tolerance must be at least twice as large as the x,y- and z-resolution.

• When using an enterprise geodatabase as an input to this tool, the current database user cannot be SDE or DBO.

Parameters

Dialog

Label	Explanation	Data Type
Input Location	The file or multipurpose geodatabase where the LRS and minimum schema will be created.	Workspace; Feature Dataset
LRS Name	The name of the output LRS.	String
Centerline Feature Class Name	The name of the output centerline feature class.	String
Calibration Point Feature Class Name	The name of the output calibration point feature class.	String
Redline Feature Class Name	The name of the output redline feature class.	String
Centerline Sequence Table Name	The name of the output centerline sequence table.	String
Spatial Reference	The spatial reference for the output feature classes. When using a Python script, you can use the Well Known ID (WKID) for the spatial reference.	Spatial Reference
XY Tolerance (Optional)	The x,y-tolerance of the output feature classes.	Linear Unit
Z Tolerance (Optional)	The z-tolerance of the output feature classes.	Linear Unit
XY Resolution (Optional)	The x,y-resolution of the output feature classes.	Linear Unit
Z Resolution (Optional)	The z-resolution of the output feature classes.	Linear Unit

Derived Output

Label	Explanation	Data Type
Updated Input Location	The updated LRS workspace.	Workspace; Feature Dataset
Output Centerline Feature Class	The updated centerline feature layer.	Feature Class
Output Calibration Point Feature Class	The updated calibration point feature layer.	Feature Class
Output Redline Feature Class	The updated redline feature layer.	Feature Class
Output Centerline Sequence Table	The updated centerline sequence table.	Table

Python

arcpy.locref.CreateLRS(in_workspace, lrs_name, centerline_feature_class_name, calibration_point_feature_class_name, redline_feature_class_name, centerline_sequence_table_name, spatial_reference, {xy_tolerance}, {z_tolerance}, {xy_resolution}, {z_resolution})

Name	Explanation	Data Type
in_workspace	The file or multipurpose geodatabase where the LRS and minimum schema will be created.	Workspace; Feature Dataset
lrs_name	The name of the output LRS.	String
centerline_feature_class_name	The name of the output centerline feature class.	String
calibration_point_feature_class_name	The name of the output calibration point feature class.	String
redline_feature_class_name	The name of the output redline feature class.	String
centerline_sequence_table_name	The name of the output centerline sequence table.	String
spatial_reference	The spatial reference for the output feature classes. When using a Python script, you can use the Well Known ID (WKID) for the spatial reference.	Spatial Reference
xy_tolerance (Optional)	The x,y-tolerance of the output feature classes.	Linear Unit
z_tolerance (Optional)	The z-tolerance of the output feature classes.	Linear Unit
xy_resolution (Optional)	The x,y-resolution of the output feature classes.	Linear Unit
z_resolution (Optional)	The z-resolution of the output feature classes.	Linear Unit

Derived Output

Name	Explanation	Data Type
out_workspace	The updated LRS workspace.	Workspace; Feature Dataset
out_centerline_feature_class	The updated centerline feature layer.	Feature Class
out_calibration_point_feature_class	The updated calibration point feature layer.	Feature Class
out_redline_feature_class	The updated redline feature layer.	Feature Class
out_centerline_sequence_table	The updated centerline sequence table.	Table

Code sample

CreateLRS example 1 (Python window)

Use the CreateLRS function in immediate mode.

# Name: Create_LRS_ex1.py
# Description: Create an LRS and minimum schema items (Centerline, Centerline Sequence, Calibration Point, Redline).
# Requires: ArcGIS Location Referencing

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

# Tool variables
in_workspace = r"C:/Data/PipelineData.gdb/"
lrs_name = "LRS"
centerline_feature_class_name = "Centerline"
calibration_point_feature_class_name = "Calibration_Point"
redline_feature_class_name = "Redline"
centerline_sequence_table_name = "Centerline_Sequence"
spatial_reference = "26111"
xy_tolerance = "0.01 Meters"
z_tolerance = "0.01 Meters"
xy_resolution = "0.001 Meters"
z_resolution = "0.001 Meters"

# Set current workspace
arcpy.env.workspace = "C:/Data/PipelineData.gdb"

# execute the tool
arcpy.locref.CreateLRS(in_workspace, lrs_name, centerline_feature_class_name, calibration_point_feature_class_name,
                       redline_feature_class_name, centerline_sequence_table_name, spatial_reference, xy_tolerance,
                       z_tolerance, xy_resolution, z_resolution)

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

CreateLRS example 2 (stand-alone script)

Use the CreateLRS function as a stand-alone Python script.

# Name: Create_LRS_ex2.py
# Description: Create an LRS and minimum schema items (Centerline, Centerline Sequence, Calibration Point, Redline).
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local Variables
in_workspace = r"C:\Data\PipelineData.gdb"
lrs_name = "LRS"
centerline_feature_class_name = "Centerline"
calibration_point_feature_class_name = "CalibrationPoint"
redline_feature_class_name = "Redline"
centerline_sequence_table_name = "CenterlineSequence"
spatial_reference = "NAD83 Albers Equal Area, 48 States, Panhandle, US Foot"
xy_tolerance = "0.001 Feet"
z_tolerance = "0.001 Feet"
xy_resolution = "0.0001 Feet"
z_resolution = "0.0001 Feet"

arcpy.locref.CreateLRS(in_workspace, lrs_name, centerline_feature_class_name, calibration_point_feature_class_name,
                       redline_feature_class_name, centerline_sequence_table_name, spatial_reference, xy_tolerance,
                       z_tolerance, xy_resolution, z_resolution)

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

Environments

Current Workspace

Licensing information

• Basic: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
• Standard: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)
• Advanced: Requires ArcGIS Location Referencing (ArcGIS Pipeline Referencing or ArcGIS Roads and Highways)