Create LRS Intersection (Location Referencing Tools)

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 must be z-enabled.
Only a comma (,) is allowed as a name separator for route-on-route intersections.

Label	Explanation	Data 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: Value table columns: 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 (Optional)	The z-tolerance that will be used to generate intersections.	Double

Derived output

Label	Explanation	Data 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})

Name	Explanation	Data 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: Value table columns: `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_Z`—Z-values will be used when generating intersections. `DO_NOT_CONSIDER_Z`—Z-values will not be used when generating intersections. This is the default.	Boolean
z_tolerance (Optional)	The z-tolerance that will be used to generate intersections.	Double

Derived output

Name	Explanation	Data 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

# 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:'"
consider_z = "DO_NOT_CONSIDER_Z"
z_tolerance = ""

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

# Run the tool
arcpy.locref.CreateLRSIntersection(parent_network, network_description_field, intersection_feature_class_name, intersecting_layers, consider_z, z_tolerance)

CreateLRSIntersection example 2 (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

# 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:'"
consider_z = "DO_NOT_CONSIDER_Z"
z_tolerance = ""

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

# Run the tool
arcpy.locref.CreateLRSIntersection(parent_network, network_description_field, intersection_feature_class_name, intersecting_layers, consider_z, z_tolerance)

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)

Create LRS Intersection (Location Referencing Tools)

Summary

Usage

Parameters

Derived output

Environments

Licensing information

Related topics