Create LRS Intersection (Location Referencing)

Summary

Creates an intersection feature class for an existing LRS Network.

The output of this tool is an empty feature class with fields that conform to the LRS data model.

Run the Generate Intersections tool to generate intersection points after using this tool.

Usage

  • The projected coordinate system of the intersecting feature classes must match that of the Parent LRS Network parameter value.

  • The Parent LRS Network parameter value can be used as an intersecting layer, so the intersections produced will be between the routes in a network.

  • The Parent LRS Network parameter value cannot be a feature service.

  • The intersecting layers must be in the same geodatabase as the Parent LRS Network parameter value.

  • The name of the intersection is created by concatenating the Network Description Field parameter value with the Description Field value in the Intersecting Layers parameter, separated by the Name Separator value in the Intersecting Layers parameter.

  • The Intersecting Layers parameter value must be z-enabled.

  • When using an enterprise geodatabase as an input to this tool, the current database user cannot be SDE or DBO.

  • Only a comma (,) is allowed as a name separator for route-on-route intersections.

Parameters

LabelExplanationData Type
Parent LRS Network

The network to which the intersection will be registered.

Feature Layer
Network Description Field

The field in the network layer that will be used to name the intersections with other intersecting layers.

Field
Intersection Feature Class

The name of the new intersection point feature class.

String
Intersecting Layers

The feature class that intersects the LRS Network and contains the following information:

  • 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
Consider z-values when generating intersections
(Optional)

Specifies whether z-values will be used when generating intersections.

  • Checked—Z-values will be used when generating intersections.
  • Unchecked—Z-values will not be used when generating intersections. This is the default.
Boolean
Z Tolerance

The z-tolerance that will be used to generate intersections.

Double

Derived Output

LabelExplanationData Type
Output Feature Class

The registered output point feature class that will be m- and z-enabled. This feature class will be empty.

Feature Class

arcpy.locref.CreateLRSIntersection(parent_network, network_description_field, intersection_feature_class_name, intersecting_layers, {consider_z}, z_tolerance)
NameExplanationData Type
parent_network

The network to which the intersection will be registered.

Feature Layer
network_description_field

The field in the network layer that will be used to name the intersections with other intersecting layers.

Field
intersection_feature_class_name

The name of the new intersection point feature class.

String
intersecting_layers
[intersecting_layers,...]

The feature class that intersects the LRS Network and contains the following information:

  • 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
consider_z
(Optional)

Specifies whether z-values will be used when generating intersections.

  • CONSIDER_ZZ-values will be used when generating intersections.
  • DO_NOT_CONSIDER_ZZ-values will not be used when generating intersections. This is the default.
Boolean
z_tolerance

The z-tolerance that will be used to generate intersections.

Double

Derived Output

NameExplanationData Type
out_feature_class

The registered output point feature class that will be m- and z-enabled. This feature class will be empty.

Feature Class

Code sample

CreateLRSIntersection example 1 (Python window)

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

# Name: Create_LRS_Intersection_ex1.py
# Description: Create a new LRS Intersection registered to an LRS Network in the Python window.
# Requires: ArcGIS Location Referencing 

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

# Local variables 
parent_network = r"C:\Demo.gdb\LRS\Network1"
network_description_field = "RouteName"
intersection_feature_class_name = "Intersection"
intersecting_layers = "[{Boundary, CountyName, CountyID, & County:}]"

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

# Execute the tool
arcpy.locref.CreateLRSIntersection(parent_network, network_description_field, intersection_feature_class_name, intersecting_layers)

# Check in license
arcpy.CheckInExtension("LocationReferencing")
CreateLRSIntersection example 1 (stand-alone script)

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

# Name: Create_LRS_Intersection_ex2.py
# Description: Create a new LRS Intersection registered to an LRS Network.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy 

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

# Local variables 
parent_network = r"C:/Demo.gdb/LRS/NonLineNetwork"
network_description_field = "RouteName"
intersection_feature_class_name = "Intersection"
intersecting_layers = "[{NonLineNetwork, RouteName, RouteName, & RouteName:}]"

# Execute the tool
arcpy.locref.CreateLRSIntersection("parent_network, network_description_field, intersection_feature_class_name, intersection_layers")

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

Related topics