Generate Intersections (Location Referencing)

Available with Location Referencing license.

Summary

Generates new intersections and updates existing intersections.

Learn more about generating and updating intersections in Pipeline Referencing or generating and updating intersections in Roads and Highways.

Usage

  • Intersection Layer is a point feature class created by the Create LRS Intersection tool that stores the LRS intersection data. This feature class is updated as the result of running this tool.

  • The Network Layer parameter value is a polyline feature class that stores the LRS Network data. You can select routes from this feature class to update their intersections. Definition filters on the network layer are also considered.

  • The route selection or definition filters are only considered if a Network Layer value is defined in the tool.

  • The Start Date parameter is used to update intersections on the routes that have been edited since the defined date.

  • You can enable editor tracking for the network layer. Editor tracking is used to find the added, updated, or edited features. Using editor tracking in conjunction with the Start Date parameter value, you can update only those intersections that have changed since the Start Date provided by the user. This may result in faster performance.

  • If the Only use routes edited by current user parameter is checked, only routes edited by the present user in the current version, as identified by ArcGIS editor tracking, will have intersections updated. For a dataset in a file geodatabase, the intersections are updated for routes that are edited by the current Windows user. Editor tracking must be enabled for the network feature class to use this functionality.

  • The routes to be processed for updating the intersections are identified based on the route selection, route definition query, date selection, and the Only use routes edited by current user parameter value. If you have provided these values, only the routes that fulfill all four conditions will be processed for updating intersections.

  • Intersections are not generated at the self-intersecting locations of a route.

Parameters

LabelExplanationData Type
Intersection Feature Class

The input LRS intersection feature class or layer.

Feature Layer
Network Layer
(Optional)

The input LRS Network feature class or layer.

Feature Layer
Start Date
(Optional)

Filters routes that have been edited after a certain date so that intersections can be generated.

Date
Only use routes edited by current user
(Optional)

Specifies whether intersections will be generated only for routes edited and locked by the current user.

  • Checked—Intersections will be generated only for routes edited by the current user. This is the default.
  • Unchecked—Intersections will be generated for all edited routes.
Boolean

Derived Output

LabelExplanationData Type
Updated Intersection Feature Class

The updated LRS intersection feature class or layer.

Feature Layer
Output Details File

A text file that details changes made by the tool.

Note:

Validation results for this tool are written to the ArcGIS Server directory. This file is automatically cleaned up in 10 minutes by default, which may not be enough time to process all of the validations and write them to your workstation that is running ArcGIS Pro. For larger data loads, it is recommended that you adjust the maximum file age to at least one hour.

Text File

arcpy.locref.GenerateIntersections(in_intersection_feature_class, {in_network_layer}, {start_date}, {edited_by_current_user})
NameExplanationData Type
in_intersection_feature_class

The input LRS intersection feature class or layer.

Feature Layer
in_network_layer
(Optional)

The input LRS Network feature class or layer.

Feature Layer
start_date
(Optional)

Filters routes that have been edited after a certain date so that intersections can be generated.

Date
edited_by_current_user
(Optional)

Specifies whether intersections will be generated only for routes edited and locked by the current user.

  • CURRENT_USERIntersections will be generated only for routes edited by the current user. This is the default.
  • ALL_USERSIntersections will be generated for all edited routes.
Boolean

Derived Output

NameExplanationData Type
out_intersection_feature_class

The updated LRS intersection feature class or layer.

Feature Layer
out_details_file

A text file that details changes made by the tool.

Note:

Validation results for this tool are written to the ArcGIS Server directory. This file is automatically cleaned up in 10 minutes by default, which may not be enough time to process all of the validations and write them to your workstation that is running ArcGIS Pro. For larger data loads, it is recommended that you adjust the maximum file age to at least one hour.

Text File

Code sample

GenerateIntersections example 1 (Python window)

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

# Name: GenerateIntersections_ex1.py
# Description: Genrates and updates intersections for intersection features registered with an LRS Network.
# Requires: ArcGIS Location Referencing

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

# Local variables
in_intersection_feature_class = r'C:\Data\Demo.gdb\LRS\LRSI1'
in_network_layer = r'C:\Data\Demo.gdb\LRS\NonLineNetwork'

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

# Execute the tool
arcpy.locref.GenerateIntersections("in_intersection_feature_class", "in_network_layer", "5/5/2020", "CURRENT_USER")

# Check in license
arcpy.CheckInExtension('LocationReferencing')
GenerateIntersections example 1 (Python window)

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

# Name: GenerateIntersections_ex2.py
# Description: Generates and updates intersections for intersection features registered with an LRS Network.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_intersection_feature_class = r'C:\Data\Demo.gdb\LRS\LRSI1'
in_network_layer = r'C:\Data\Demo.gdb\LRS\NonLineNetwork'

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

# Execute the tool
arcpy.locref.GenerateIntersections("in_intersection_feature_class", "in_network_layer", "5/5/2020", "CURRENT_USER")

# 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