Overlay Route Events

Summary

Overlays two or more linear event feature layers against a target network and outputs a feature class or event table that represents the dynamic segmentation of the inputs.

Usage

• All input Event Layers must be line events.

• The Event Layers parameter may only include 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_locref (in_network, {network_fields}, 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
network_fields [network_fields,...] (Optional)	Fields from the Network Layer that will be included in the output.	Field
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

OverlayRouteEvents example 1 (Python window)

The following Python window script demonstrates how to use the OverlayRouteEvents tool in immediate mode.

# tool variables
in_network = "AllRoutes"
network_fields = ["RouteName", "Routeid", "RouteNumber"]
event_layers = ["FunctionalClass","Ownership"]
include_geometry = "EXCLUDE_GEOMETRY"
output_rows = r"C:\data\Outputs.gdb\ArcPy_OverlayEventsResult"
output_features = ""

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

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

OverlayRouteEvents example 2 (stand-alone script)

The following Python script demonstrates how to use the OverlayRouteEvents tool in a 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:
in_network = r"C:\data\RHData.gdb\AllRoutes"
network_fields = ["RouteName", "Routeid", "RouteNumber"]
event_layers = [r"C:\data\RHData.gdb\FunctionalClass",r"C:\data\RHData.gdb\Ownership"]
include_geometry = "INCLUDE_GEOMETRY"
output_rows = ""
output_features = r"C:\data\Outputs.gdb\OverlayEventsResult"

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

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