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:

    FieldData typeCharacter lengthNullableDescription

    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

LabelExplanationData 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

LabelExplanationData Type
Output Details File

The updated Intersection Feature Class.

Feature Class

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})
NameExplanationData 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

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

Related topics