Configure Utility Network Feature Class (Location Referencing)

Summary

Configures a Utility Network pipeline feature class for use with a linear referencing system (LRS).

After configuration, the Route ID Field parameter and the measure columns can be updated as needed.

Usage

• The Utility Network Feature Layer must be configured as the pipeline feature class in the Utility Network and as the centerline feature class in the LRS.

  Learn more about the LRS data model in ArcGIS Pipeline Referencing

• The Route ID Field parameter type and length must match that of the centerline sequence table in the LRS.

• This tool requires a branch versioned enterprise geodatabase connection.

  Learn more about versioning in ArcGIS Pro

• This tool is not supported in feature services.

Parameters

Dialog

Label	Explanation	Data Type
Utility Network Feature Layer	The input Utility Network feature that is also the LRS centerline feature.	Feature Layer
Route ID Field	The field in the feature class that will be mapped as the LRS Network Route ID.	Field
From Measure Field	The From measure field of the centerline feature class.	Field
To Measure Field	The To measure field of the centerline feature class.	Field

Derived Output

Label	Explanation	Data Type
Output Feature Class	The updated Utility Network feature layer.	Feature Layer

Python

arcpy.locref.ConfigureUtilityNetworkFeatureClass(in_feature_class, route_id_field, from_measure_field, to_measure_field)

Name	Explanation	Data Type
in_feature_class	The input Utility Network feature that is also the LRS centerline feature.	Feature Layer
route_id_field	The field in the feature class that will be mapped as the LRS Network Route ID.	Field
from_measure_field	The From measure field of the centerline feature class.	Field
to_measure_field	The To measure field of the centerline feature class.	Field

Derived Output

Name	Explanation	Data Type
out_feature_class	The updated Utility Network feature layer.	Feature Layer

Code sample

ConfigureUtilityNetworkFeatureClass example 1 (Python window)

Demonstrates how to use the ConfigureUtilityNetworkFeatureClass geoprocessing tool in a Python window.

# Name: ConfigureUtilityNetworkFeatureClass_ex1.py
# Description: Configure a Utility Network pipeline feature class for use with a linear referencing system (LRS) in the Python window.
# Requires: ArcGIS Location Referencing

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

# Set current workspace
arcpy.env.workspace = "C:/Data/UN_LRconnection.sde"

# Tool variables
utility_Network_Feature = r"C:/Data/UN_LRconnection.sde/LRS/UNOWNER.UNData/UNOWNER.pipeline"
RouteID = "RouteID"
FromMeasure = "FromMeasure"
ToMeasure = "ToMeasure"

# Execute the tool
arcpy.locref.ConfigureUtilityNetworkFeatureClass(utility_Network_Feature, RouteID, FromMeasure, ToMeasure)

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

ConfigureUtilityNetworkFeatureClass example 2 (stand-alone script)

Demonstrates how to use the ConfigureUtilityNetworkFeatureClass tool as a stand-alone Python script.

# Name: ConfigureUtilityNetworkFeatureClass_ex2.py
# Description: Configure a Utility Network pipeline feature class for use with a linear referencing system (LRS) in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Set current workspace
arcpy.env.workspace = "C:/Data/UN_LRconnection.sde"

#Tool variables
utility_Network_Feature = r"C:/Data/UN_LRconnection.sde/LRS/UNOWNER.UNData/UNOWNER.pipeline"
RouteID = "RouteID"
FromMeasure = "FromMeasure"
ToMeasure = "ToMeasure"

# Execute the tool
arcpy.locref.ConfigureUtilityNetworkFeatureClass(utility_Network_Feature, RouteID, FromMeasure, ToMeasure)

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