Enable Stationing Fields (Location Referencing)

Summary

Enables or modifies stationing fields so that you can manage referent information for the registered LRS event.

Stationing is the fundamental system of measurement used for route layout and construction. Stations are reference points that are placed at some regular interval along the horizontal measurement of a route centerline. A starting reference station is established and all distances along the route centerline are measured from that station point.

Learn more about stationing in the ArcGIS Pipeline Referencing events data model or stationing in the ArcGIS Roads and Highways events data model.

Usage

• Registering a stationing event layer allows you to locate stations with ahead and back station values at any measure along a route in an LRS Network.

• Only one stationing event layer can be configured in an LRS Network.

• If stationing fields are already configured, this tool will populate the existing fields so that they can be modified.

• The Back Station Field value is populated when an equation point is present at the station location.

• The values in the Decreasing Station Values field indicate that the station values decrease toward the direction of calibration of the route. A blank value or no value indicates that the station values increase toward the direction of calibration of the route.

Parameters

Dialog

Label	Explanation	Data Type
Event Feature Class	An existing event feature class or feature layer that is registered to an LRS.	Feature Layer
Station Field (Optional)	The field that will be used as the starting reference station.	Field
Back Station Field (Optional)	The field that will be used as the back station.	Field
Station Value Direction Field (Optional)	The field that will be used to indicate the direction of increasing stations, either increasing toward the direction of calibration of the route or away from it.	Field
Station Measure Units (Optional)	Specifies the measure units that will be used for stationing. Miles (US Survey)—The unit of measure will be miles. This is the default. Inches (US Survey)—The unit of measure will be inches. Feet (US Survey)—The unit of measure will be feet. Yards (US Survey)—The unit of measure will be yards. Nautical miles (US Survey)—The unit of measure will be nautical miles. Feet (International)—The unit of measure will be international feet. Millimeters—The unit of measure will be millimeters. Centimeters—The unit of measure will be centimeters Meters—The unit of measure will be meters. Kilometers—The unit of measure will be kilometers. Decimeters—The unit of measure will be decimeters.	String
Decreasing Station Values (Optional)	A comma-separated list of user-provided values.	String

Derived Output

Label	Explanation	Data Type
Output Event Feature Class	The updated feature layer for the event.	Feature Layer

Python

arcpy.locref.EnableStationingFields(in_feature_class, {station_field}, {back_station_field}, {station_direction_field}, {station_measure_units}, {decreasing_station_values})

Name	Explanation	Data Type
in_feature_class	An existing event feature class or feature layer that is registered to an LRS.	Feature Layer
station_field (Optional)	The field that will be used as the starting reference station.	Field
back_station_field (Optional)	The field that will be used as the back station.	Field
station_direction_field (Optional)	The field that will be used to indicate the direction of increasing stations, either increasing toward the direction of calibration of the route or away from it.	Field
station_measure_units (Optional)	Specifies the measure units that will be used for stationing. MILES—The unit of measure will be miles. This is the default. INCHES—The unit of measure will be inches. FEET—The unit of measure will be feet. YARDS—The unit of measure will be yards. NAUTICAL_MILES—The unit of measure will be nautical miles. INTFEET—The unit of measure will be international feet. MILLIMETERS—The unit of measure will be millimeters. CENTIMETERS—The unit of measure will be centimeters METERS—The unit of measure will be meters. KILOMETERS—The unit of measure will be kilometers. DECIMETERS—The unit of measure will be decimeters.	String
decreasing_station_values (Optional)	A comma-separated list of user-provided values.	String

Derived Output

Name	Explanation	Data Type
out_feature_class	The updated feature layer for the event.	Feature Layer

Code sample

EnableStationingFields example 1 (Python window)

The following Python window script demonstrates how to use the EnableStationingFields function in immediate mode.

# Name: EnableStationingFields_Pro_ex1.py
# Description: Enables or modifies stationing fields to manage referent
# information for the registered LRS event.
# Requires: ArcGIS Location Referencing

# Tool variables 
in_feature_class = "c:\\LocationReferencing.sde\\LRS\LineEventFeatureClass"
station_field = "Ahead Station"
back_station_field = "Back Station"
station_direction_field = "StnDirection"
station_measure_units = "Feet"
decreasing_station_values = "0,-1,-2"

# Execute the tool
arcpy.locref.EnableStationingFields(in_feature_class, station_field,
                                    back_station_field, station_direction_field,
                                    station_measure_units, decreasing_station_values)

EnableStationingFields example 2 (stand-alone script)

The following script demonstrates how to use the EnableStationingFields function in a stand-alone Python script.

# Name: EnableStationingFields_Pro_ex2.py
# Description: Enables or modifies stationing fields to manage referent
# information for the registered LRS event.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Tool variables 
in_feature_class = "c:\\APR.gdb\\LRS\LineEventFeatureClass"
station_field = "Ahead Station"
back_station_field = "Back Station"
station_direction_field = "StnDirection"
station_measure_units = "Feet"
decreasing_station_values = ""

# Execute the tool
arcpy.locref.EnableStationingFields(in_feature_class, station_field,
                                    back_station_field, station_direction_field,
                                    station_measure_units, decreasing_station_values)

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

Environments

This tool does not use any geoprocessing environments.

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)