Overlay Route Events

Summary

Overlays two or more event feature layers against a target network and outputs a feature class or event table that represents the union of the input.

Usage

• All input Event Layers must be line events.

• The Event Layers parameter must be one of the linear event feature classes registered with an Esri Roads and Highways network.

• If the input events use different Linear Referencing Methods (LRM), they will be translated against the LRM of the target network.

• This tool only supports translating one time view of a network.

• This tool does not support selection sets.

• This tool supports definition filters.

• The output can be saved as either an Output Table or an Output Feature Class.

• If saved as a feature class, the output will have the following indexes and fields:

  Index:	Fields:
  Route_ID	Route_ID
  RID_Measures	Route_ID From_Measure To_Measure

Syntax

OverlayRouteEvents_roads (in_Network, event_layers, {include_geometry}, {output_rows}, {output_features})

Parameter	Explanation	Data Type
in_Network	The target network against which the event layers will be dynamically segmented.	Feature Layer
event_layers [event_layers,...]	The event layers to be dynamically segmented together against a target network.	Feature Layer
include_geometry (Optional)	Determines whether the output_features or output_rows will be created with the event records. EXCLUDE_GEOMETRY —Will not include the event geometry in the output_rows. Event records will be stored as a table. This is the default. INCLUDE_GEOMETRY —Will include the event geometry in the output_features. Event records will be stored as a feature class.	Boolean
output_rows (Optional)	The table to be created, containing the output event records without geometry. This parameter is required when the include_geometry parameter is set to EXCLUDE_GEOMETRY.	Table
output_features (Optional)	The feature class to be created, containing the output event records with geometry. This parameter is required when the include_geometry parameter is set to INCLUDE_GEOMETRY.	Feature Class

Code sample

Overlay Route Events (Python window)

The following Python window script demonstrates how to use the Overlay Route Events tool in immediate mode.

#tool variables
in_network=r"C:\Data\NY_Data.gdb\LRSN_MilePoint"
event_layers=[r"C:\Data\NY_Data.gdb\LRSE_Functional_Class",r"C:\Data\NY_Data.gdb\LRSE_Median"]
include_geometry=""
output_rows=r"C:\Data\NY_Data.gdb\ArcPy_Test"
output_features=""

# execute the tool
arcpy.OverlayRouteEvents_roads(in_network, event_layers, include_geometry, output_rows, output_features)

Overlay Route Events (Stand-alone Python script)

The following Python window script demonstrates how to use the Overlay Route Events tool in stand-alone Python script.

# Name: OverlayRouteEvents.py
# Description: Dynamically segment two or more event feature layers against a target LRS network.
# Requires: Esri Roads and Highways Solution 

# Import arcpy module
import arcpy

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

# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Table = r"C:\Data\NY_Data.gdb\Output"
Output_Feature_Class = ""

# Process: Overlay Route Events
arcpy.OverlayRouteEvents_roads(Network, Events, "EXCLUDE_GEOMETRY", Output_Table, Output_Feature_Class)

Environments

• Current Workspace

Licensing information

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