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

LabelExplanationData 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.
  • MillimetersThe unit of measure will be millimeters.
  • CentimetersThe unit of measure will be centimeters
  • MetersThe unit of measure will be meters.
  • KilometersThe unit of measure will be kilometers.
  • DecimetersThe unit of measure will be decimeters.
String
Decreasing Station Values
(Optional)

A comma-separated list of user-provided values.

String

Derived Output

LabelExplanationData Type
Output Event Feature Class

The updated feature layer for the event.

Feature Layer

arcpy.locref.EnableStationingFields(in_feature_class, {station_field}, {back_station_field}, {station_direction_field}, {station_measure_units}, {decreasing_station_values})
NameExplanationData 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.

  • MILESThe unit of measure will be miles. This is the default.
  • INCHESThe unit of measure will be inches.
  • FEETThe unit of measure will be feet.
  • YARDSThe unit of measure will be yards.
  • NAUTICAL_MILESThe unit of measure will be nautical miles.
  • INTFEETThe unit of measure will be international feet.
  • MILLIMETERSThe unit of measure will be millimeters.
  • CENTIMETERSThe unit of measure will be centimeters
  • METERSThe unit of measure will be meters.
  • KILOMETERSThe unit of measure will be kilometers.
  • DECIMETERSThe unit of measure will be decimeters.
String
decreasing_station_values
(Optional)

A comma-separated list of user-provided values.

String

Derived Output

NameExplanationData 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
  • Standard: Requires ArcGIS Location Referencing
  • Advanced: Requires ArcGIS Location Referencing

Related topics