Help

Update Intersection Points

Summary

Helps generate and update LRS intersection point features.

Usage

  • This tool requires an ArcGIS for Desktop Advanced license.

  • Turn on 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. For more information on the Editor Tracking tool, see Enable Editor Tracking.

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

  • Network Layeris 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 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.

  • 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 railroads or 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 activityRoute and route intersectionRoute and non-LRS layer intersection

    Route edits

    Retires the present intersections and/or creates new intersections

    Retires the present intersections and/or creates new intersections

    Cartographic realignment: Intersecting as a result

    Moves the present intersections and/or creates new 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

UpdateIntersectionPoints_roads (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})
ParameterExplanationData 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 the LRS network data. 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 turned on.

Date
in_lock_routes
(Optional)

Routes for which intersections are being calculated will be locked.

Boolean
in_lock_intersecting_routes
(Optional)

All routes that intersect with routes for which intersections are being calculated will 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.

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="Intersections"
in_network="MilePoint"
in_start_time="01/01/2012"
in_lock_routes="LOCK_ROUTES"
in_lock_intersecting_routes="LOCK_INTERSECTING_ROUTES"
in_only_calculate_intersections_for_routes_edited_by_me_in_current_version="ONLY_CALCULATE_INTERSECTIONS_FOR_ROUTES_EDITED_BY_ME_IN_CURRENT_VERSION"

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

# execute the tool with all options
arcpy.UpdateIntersectionPoints_roads ("Intersections", "Milepoint", "01/01/2012", "LOCK_ROUTES", "LOCK_INTERSECTING_ROUTES", "ONLY_CALCULATE_INTERSECTIONS_FOR_ROUTES_EDITED_BY_ME_IN_CURRENT_VERSION")

Environments

Licensing information

  • ArcGIS Desktop Basic: No
  • ArcGIS Desktop Standard: No
  • ArcGIS Desktop Advanced: Requires Roads and Highways

Related topics