Resumen
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.
Uso
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
Sintaxis
arcpy.locref.OverlayRouteEvents(in_network, {network_fields}, event_layers, {include_geometry}, {output_rows}, {output_features})
Parámetro | Explicación | Tipo de datos |
in_network | The target network against which the event layers will be dynamically segmented. | Feature Layer |
network_fields [network_fields,...] (Opcional) | 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 (Opcional) | Determines whether the output_features or output_rows will be created with the event records.
| Boolean |
output_rows (Opcional) | 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 (Opcional) | 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 |
Muestra de código
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.
# 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)
Entornos
Información sobre licencias
- Basic: Requiere Roads and Highways
- Standard: Requiere Roads and Highways
- Advanced: Requiere Roads and Highways