Update Intersection Points

Summary

Generates and updates LRS intersection point features.

Usage

• This tool requires an ArcGIS Desktop Advanced license.

• Enable Editor Tracking for the network and the intersecting layers. Editor tracking, in conjunction with the Start Time parameter, makes it possible to only update intersections that have changed since the Start Time provided by the user. Doing so may result in faster performance.

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

• Network Layer is a polyline feature class that stores network data in the LRS. You can select routes from this feature class to update their intersections. Definition filters on the network layer are also considered when selecting routes with intersections that need updating.

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

• The Start Time is used to update route intersections and intersecting features that have been edited since this time. This option is only available for datasets that have Editor Tracking enabled. If Editor Tracking is not enabled in any of the intersecting layers, the intersections are updated for all the routes present in the dataset.

• Conflict prevention is not supported by this tool in ArcGIS Pipeline Referencing.

• Points that are not part of the intersecting layers are not updated using this tool.

• When intersections are updated, the following situations can occur:

  • New intersections are created—New intersections can be created due to edit activities such as creating a route, realigning a route, extending a route, reassigning a route, cartographic realignment, or other edit activities including non-LRS features such as political boundaries.
  • Present intersections are retired—An intersection is retired with its ToDate field populated with the route's edit date due to realigning a route, retiring a route, reassigning a route, or other edit activities.
  • Present intersections are moved—Intersections are moved due to cartographic realignment or edits of non-LRS features. In such cases, that intersection's location is changed, and the shape (point location) for the intersection is updated, maintaining the intersection ID. The intersections are not retired in this case. If a feature intersects a route in multiple locations and the intersection locations change, the original intersection closest to the new location determines where the intersection is moved.
  • Present intersections are deleted—Intersections are deleted due to cartographic realignment or edits of non-LRS features. This occurs when the routes do not intersect the features anymore in any time range.

  The following table shows the various scenarios when updating the intersections:

  Edit activity	Route and route intersection	Route and non-LRS layer intersection
  Route edits	Retires the present intersections or creates intersections	Retires the present intersections or creates intersections
  Cartographic realignment: Intersecting as a result	Moves the present intersections or creates intersections	Moves the present intersections
  Cartographic realignment: Not intersecting anymore	Deletes the present intersections	Deletes the present intersections
  Non-LRS feature edited: Intersecting as a result	N/A	Moves the present intersections
  Non-LRS feature edited: Not intersecting anymore	N/A	Deletes the present intersections

Syntax

arcpy.locref.UpdateIntersectionPoints(in_intersection_layer, {in_network}, {in_start_time}, {in_lock_routes}, {in_lock_intersecting_routes}, {in_only_calculate_intersections_for_routes_edited_by_me_in_current_version})

Parameter	Explanation	Data Type
in_intersection_layer	The LRS intersection feature class that needs to be updated.	Feature Layer
in_network (Optional)	The polyline feature class that stores network data in the LRS. You can select routes from this feature class for which the intersections will be updated. Definition filters on the network layer are also considered when selecting the routes with intersections to be updated.	Feature Layer
in_start_time (Optional)	This value is used to update intersections for routes and intersecting features that have been edited since the start time for those layers that have editor tracking enabled.	Date
in_lock_routes (Optional)	Indicates whether routes for which intersections are being calculated will be locked. This parameter is not supported in Pipeline Referencing. LOCK_ROUTES —Routes for which intersections are being calculated will be locked. This is the default. DO_NOT_LOCK_ROUTES —Routes for which intersections are being calculated will not be locked.	Boolean
in_lock_intersecting_routes (Optional)	Indicates whether all routes that intersect with routes for which intersections are being calculated will be locked. This parameter is not supported in Pipeline Referencing. LOCK_INTERSECTING_ROUTES —Routes that intersect with routes for which intersections are being calculated will be locked. This is the default. DO_NOT_LOCK_INTERSECTING_ROUTES —Routes that intersect with routes for which intersections are being calculated will not be locked.	Boolean
in_only_calculate_intersections_for_routes_edited_by_me_in_current_version (Optional)	Only routes edited by the present user as indicated in Editor Tracking will have the intersections calculated for the current version of the data. ONLY_CALCULATE_INTERSECTIONS_FOR_ROUTES_EDITED_BY_ME_IN_CURRENT_VERSION —Calculate intersections for routes edited by the present user as indicated in Editor Tracking for the current version of the data. This is the default. CALCULATE_INTERSECTIONS_FOR_ALL_ROUTES —Calculate intersections for all routes.	Boolean

Code sample

UpdateIntersectionPoints example 1 (Python window)

The following Python window script demonstrates how to use the UpdateIntersectionPoints tool:

# tool variables
in_intersection_layer = "route_intersections"
in_start_time = "01/01/2012 02:10:32 AM"

# set current workspace
arcpy.env.workspace = "C:/data/Outputs.gdb"

# execute the tool
arcpy.UpdateIntersectionPoints_locref(in_intersection_layer, in_start_time)

UpdateIntersectionPoints example 2 (stand-alone script)

The following Python window script demonstrates how to use the UpdateIntersectionPoints tool in a stand-alone Python script:

# Name: UpdateIntersections_standalone.py
# Description: Updates LRS intersection points
# Requirements: ArcGIS Pipeline Referencing

# Import arcpy module
import arcpy

# Check out any necessary licenses
arcpy.CheckOutExtension("LocationReferencing")

# Local variables
in_intersection_layer = "C:/RoadsAndHighways/Data/NY_data.gdb/LRSI_Routes_n_Counties"
in_start_time = "02/01/2013 02:10:32 AM"

# Process: Update Intersection Points
arcpy.UpdateIntersectionPoints_locref(in_intersection_layer, in_start_time )

Environments

• Current Workspace

Licensing information

• Basic: No
• Standard: No
• Advanced: Requires ArcGIS Pipeline Referencing