Modify LRS Intersection (Location Referencing)

Summary

Modifies the properties of an intersection feature class, such as fields and intersecting layers, that compose the intersection feature class and can be added or removed.

Usage

• The input Intersection Feature Class parameter value should be a feature layer and cannot be a service layer.

• This tool can be used on a feature class without geometry or records.

• The spatial reference, tolerance, and resolution of the Intersection Feature Class and Intersecting Layers parameter values must match.

• The Intersection Feature Class and Intersecting Layers parameter values must be in the same workspace.

• Feature classes provided as Intersecting Layers must be z-enabled.

• The sum of Intersecting Layers field lengths must be less than or equal to the Intersection Name Field length.

• The Intersection Feature Class must have the following fields configured:

  Field	Data type	Character length	Nullable	Description
  IntersectionId	Field (Guid)	38	No	An automatically generated field providing a unique ID for each intersection.
  IntersectionName	String	1000	Yes	A concatenated field showing the descriptors for the route and intersecting feature.
  RouteId	String	1000	No	The route ID of the route network.
  FeatureId	String	1000	Yes	The ID of the intersecting feature.
  FeatureClassName	String	150	No	The name of the feature class that participated in the intersection.
  FromDate	Date	NA	Yes	The From Date of the route.
  ToDate	Date	NA	Yes	The To Date of the route.
  Measure	Double	NA	Yes	The measure on the base route at the point of intersection.

Parameters

Dialog

Label	Explanation	Data Type
Intersection Feature Class	The input LRS intersection feature layer. This feature class cannot be a service.	Feature Layer
Intersection ID Field (Optional)	The field in the Intersection Feature Class to use as the intersection unique ID field.	Field
Intersection Name Field (Optional)	The concatenated field in the Intersection Feature Class that contains the descriptors for the route and the intersecting feature.	Field
Route ID Field (Optional)	The field in the Intersection Feature Class that contains the unique route ID.	Field
Feature ID Field (Optional)	The field in the Intersection Feature Class that contains the ID of the intersecting feature.	Field
Feature Class Name Field (Optional)	The field in the Intersection Feature Class that contains the name of the feature class that participated in the intersection.	Field
From Date Field (Optional)	The field in the Intersection Feature Class that contains the from date of the route.	Field
To Date Field (Optional)	The field in the Intersection Feature Class that contains the to date of the route.	Field
Intersecting Layers (Optional)	The Intersection Feature Class fields that compose the intersecting layer. Intersection Layer—The feature class that intersects the LRS Network. ID Field—The field in the intersecting layer used to uniquely identify the feature that intersects the network. Description Field—The field that provides the description, such as town or county name, of the intersecting feature. Name Separator—The name separator for the intersection, such as AND, INTERSECT, +, or |.	Value Table
Measure Field (Optional)	The field in the Intersection Feature Class that contains the measure on the base route at the point of intersection.	Field

Derived Output

Label	Explanation	Data Type
Output Details File	The updated Intersection Feature Class.	Feature Class

Python

arcpy.locref.ModifyLRSIntersection(in_feature_class, {intersection_id_field}, {intersection_name_field}, {route_id_field}, {feature_id_field}, {feature_class_name_field}, {from_date_field}, {to_date_field}, {intersecting_layers}, {measure_field})

Name	Explanation	Data Type
in_feature_class	The input LRS intersection feature layer. This feature class cannot be a service.	Feature Layer
intersection_id_field (Optional)	The field in the Intersection Feature Class to use as the intersection unique ID field.	Field
intersection_name_field (Optional)	The concatenated field in the Intersection Feature Class that contains the descriptors for the route and the intersecting feature.	Field
route_id_field (Optional)	The field in the Intersection Feature Class that contains the unique route ID.	Field
feature_id_field (Optional)	The field in the Intersection Feature Class that contains the ID of the intersecting feature.	Field
feature_class_name_field (Optional)	The field in the Intersection Feature Class that contains the name of the feature class that participated in the intersection.	Field
from_date_field (Optional)	The field in the Intersection Feature Class that contains the from date of the route.	Field
to_date_field (Optional)	The field in the Intersection Feature Class that contains the to date of the route.	Field
intersecting_layers [intersecting_layers,...] (Optional)	The Intersection Feature Class fields that compose the intersecting layer. Intersection Layer—The feature class that intersects the LRS Network. ID Field—The field in the intersecting layer used to uniquely identify the feature that intersects the network. Description Field—The field that provides the description, such as town or county name, of the intersecting feature. Name Separator—The name separator for the intersection, such as AND, INTERSECT, +, or |.	Value Table
measure_field (Optional)	The field in the Intersection Feature Class that contains the measure on the base route at the point of intersection.	Field

Derived Output

Name	Explanation	Data Type
out_feature_class	The updated Intersection Feature Class.	Feature Class

Code sample

ModifyLRSIntersection example 1 (Python window)

The following script demonstrates how to use the ModifyLRSIntersection function in the Python window.

# Name: Modify_LRS_Intersection_ex1.py
# Description: Modifies an existing LRS Intersection feature class.
# Requires: ArcGIS Location Referencing license

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

# Tool variables
in_feature_class = r"C:\ArcGIS\Projects\Demo1\Demo\Demo.gdb\LRS\Intersection"
intersection_id_field = "IntersectionId"
intersection_name_field = "IntersectionName"
route_id_field = "RouteId"
feature_id_field = "featureId"
feature_class_name_field = "featureClassName"
from_date_field = "FromDate"
to_date_field = "ToDate"
intersecting_layers = "[{LineNetwork, RouteId, RouteId, & RouteId:}]"
measure_field = "Measure"

# Set current workspace
arcpy.env.workspace = "C:\ArcGIS\Projects\Demo1\Demo\Demo.gdb"

# Execute the tool
arcpy.locref.ModifyLRSIntersection(in_feature_class, intersection_id_field, intersection_name_field,
                                   route_id_field, feature_id_field, feature_class_name_field, from_date_field, 
                                   to_date_field, intersecting_layers, measure_field)

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

ModifyLRSIntersection example 2 (stand-alone script)

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

# Name: Modify_LRS_Intersection_ex2.py
# Description: Modifies properties of an intersection feature class.
# Requires: ArcGIS Location Referencing license

# Import arcpy module
import arcpy 

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

# Tool variables
in_feature_class = r"C:\Demo.gdb\LRS\Intersection"
intersection_id_field = "IntersectionId"
intersection_name_field = "IntersectionName"
route_id_field = "RouteId"
feature_id_field = "featureId"
feature_class_name_field = "featureClassName"
from_date_field = "FromDate"
to_date_field = "ToDate"
intersecting_layers = "[{LineNetwork, RouteId, RouteId, & RouteId:}]"
measure_field = "Measure"

# Execute the tool
arcpy.locref.ModifyLRSIntersection(in_feature_class, intersection_id_field, 
                                   intersection_name_field, route_id_field, 
                                   feature_id_field, feature_class_name_field, 
                                   from_date_field, to_date_field, intersecting_layers,
                                   measure_field)

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