| Etiqueta | Explicación | Tipo de datos |
Entidades de ruta de entrada | Red de destino en la que se segmentarán dinámicamente las capas de sucesos. | Feature Layer |
Capas de eventos | Capas de eventos que se segmentarán dinámicamente en una red de destino. La capa de línea de centro se puede utilizar como entrada para segmentar dinámicamente los eventos. | Feature Layer |
Dataset de salida | Tabla o clase de entidad que contiene los registros de eventos de salida que se crearán. | Table |
Incluir geometría (Opcional) | Especifica si el valor del parámetro Dataset de salida incluirá geometría de eventos.
| Boolean |
Campos de red (Opcional) | Campos de la capa de red que se incluirán en la salida. | Field |
Tipo de división del bloque de direcciones (Opcional) | Especifica cómo se actualizan los rangos de direcciones para cada segmento de la salida. Este parámetro solo está disponible cuando se utiliza una capa de rango de direcciones configurada como capa de eventos de entrada.
| String |
Disponible con licencia de Location Referencing.
Resumen
Superpone una o varias capas de eventos lineales y puntuales a una red de destino y genera una clase o tabla de entidades que representa la segmentación dinámica de las entradas.
Ilustración
Uso
La siguiente tabla es el resultado de la ilustración de la herramienta anterior:
Salida (Superponer eventos)
Tipo Medición Inicial Medición Final Evento de línea 1 Evento de línea 2 Evento de punto Línea
0
2
A
1
<Null>
Punto
2
2
A
1
PE1
Línea
2
3
A
1
<Null>
Línea
3
4
B
1
<Null>
Línea
4
5
B
2
<Null>
Los valores del parámetro Capas de eventos pueden ser solo eventos de línea o pueden incluir tanto eventos de punto como de línea.
El parámetro Capas de eventos solo puede incluir clases de entidades de eventos registradas con una red LRS.
Nota:
- La clase de entidad de línea de centro puede ser la entrada del parámetro Capas de eventos para segmentar los eventos de forma dinámica si forman parte de una configuración de Address Data Management o de una configuración de ArcGIS Utility Network. Cuando la clase de entidad de línea de centro forma parte de una configuración de Address Data Management, la dirección de la línea de centro se respeta en la salida.
- En una configuración de Address Data Management, utilice la herramienta Configurar clases de entidad para configurar la clase de entidad de línea de centro para utilizarla con un LRS.
- En una configuración de Utility Network, utilice la herramienta Configurar clase de entidad de red de servicios para configurar la clase de entidad de línea de centro para utilizarla con un LRS.
Si la capa de entrada tiene campos de rango de direcciones de una configuración de Address Data Management y está configurada como una clase de entidad de rango de direcciones en un LRS, los valores de los campos de rango de direcciones se actualizarán proporcionalmente para cada segmento en la salida cuando el valor de Tipo de división del bloque de direcciones sea Proporcional. Si el valor del parámetro es Punto de dirección más cercano, los rangos de direcciones se actualizarán para cada segmento en la salida en función de los puntos de dirección aguas arriba y aguas abajo más cercanos.
Si las capas de eventos de entrada utilizan métodos de referenciación lineal (LRM) diferentes, se traducirán utilizando el LRM de la red de destino.
Esta herramienta admite conjuntos de selección y consultas de definición en los valores de los parámetros Entidades de la ruta de entrada y Capas de eventos.
Nota:
Para incluir todos los registros de eventos asociados a las rutas de entrada, desactive el botón de alternancia Usar los registros seleccionados o Usar los registros filtrados para cada capa de eventos de entrada.
Esta herramienta admite capas de eventos de entrada configuradas para contener eventos que abarcan varias rutas. La salida seguirá segmentando dinámicamente a nivel de ruta de la red de destino utilizando el valor del parámetro Campos de red.
Esta herramienta admite la segmentación temporal (intervalos de tiempo). Esto ocurrirá de forma predeterminada y puede anularse creando una consulta de definición basada en el tiempo o aplicando un conjunto de selección a las entradas
Esta herramienta admite la inclusión de uno o más campos de la clase de entidades de red en la salida utilizando el parámetro Campos de red.
El resultado puede guardarse en forma de tabla o de clase de entidad.
Si la salida se guarda como una tabla o clase de entidad, la salida tendrá los siguientes índices y campos:
Índice Campo route_id
- Route_ID
rid_dates_measures
- Route_ID
- From_Date
- To_Date
- From_Measure
- To_Measure
Si existe más de una red LRS en una configuración de Utility Network, las medidas para las capas de eventos de entrada coincidirán con las medidas mostradas en la segunda columna de la siguiente tabla:
Si el LRS con la configuración de Utility Network contiene Las medidas de la clase de entidad de línea de canalización pertenecen a Red de línea, red sin línea
Red de línea
Red de línea
Red de línea
Más de una red de línea
Red de línea con la red derivada
Más de una red de línea sin ninguna red derivada
Red de línea que tiene el número más bajo en el dominio de valor codificado, dLRSNetworks
Más de una red de línea con red derivada
Red de línea que tiene el número más bajo en el dominio de valor codificado, dLRSNetworks
Una red sin líneas
Red sin líneas
Más de una red sin líneas
Red que tiene el número más bajo en el dominio de valor codificado, dLRSNetworks
Esta herramienta admite rutas y eventos con huecos físicos como rutas de entrada y eventos de entrada, respectivamente.
Solo puede haber un evento por capa en un segmento de ruta. Por ejemplo, para una capa denominada Límite de velocidad, solo un registro de evento en esa capa puede estar en ese segmento. Un segmento puede tener múltiples eventos, cada uno en su propia capa de eventos. Utilice la casilla Mediciones de evento no válidas de ArcGIS Data Reviewer para identificar y resolver problemas relacionados con datos de eventos.
Parámetros
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields}, {address_block_split_type})| Nombre | Explicación | Tipo de datos |
in_route_features | Red de destino en la que se segmentarán dinámicamente las capas de sucesos. | Feature Layer |
event_layers [event_layers,...] | Capas de eventos que se segmentarán dinámicamente en una red de destino. La capa de línea de centro se puede utilizar como entrada para segmentar dinámicamente los eventos. | Feature Layer |
output_dataset | Tabla o clase de entidad que contiene los registros de eventos de salida que se crearán. | Table |
include_geometry (Opcional) | Especifica si el valor del parámetro output_dataset incluirá geometría de eventos.
| Boolean |
network_fields [network_fields,...] (Opcional) | Campos de la capa de red que se incluirán en la salida. | Field |
address_block_split_type (Opcional) | Especifica cómo se actualizan los rangos de direcciones para cada segmento de la salida.
Este parámetro solo está disponible cuando se utiliza una capa de rango de direcciones configurada como capa de eventos de entrada. | String |
Muestra de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función OverlayEvents en la ventana de Python.
# Name: OverlayEvents_ex1.py
# Description: Overlays linear event feature layers against a target network and output a feature class or table that represents the dynamic segmentation of those inputs.
# Requirements: ArcGIS Location Referencing
# tool variables
in_route_features = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
event_layers = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRS\LRSE_Functional_Class"]
output_dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
network_fields = ""
address_block_split_type = ""
# Set current workspace
arcpy.env.workspace = r"C:\Data\NY_Data.gdb"
# Execute the tool
arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, Geometry, network_fields, address_block_split_type)La siguiente secuencia de comandos de Python muestra cómo utilizar la función OverlayEvents en una secuencia de comandos de Python independiente.
# Name: OverlayEvents_ex2.py
# Description: Overlay linear event feature layers against a target network then output a feature class or table that represents the dynamic segmentation of those inputs.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
# Local variables:
Network = r"C:\Data\NY_Data.gdb\LRS\LRSN_MilePoint"
Events = [r"C:\Data\NY_Data.gdb\LRS\LRSE_Access_Control", r"C:\Data\NY_Data.gdb\LRSE_Functional_Class"]
Output_Dataset = r"C:\Data\NY_Data.gdb\Output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""
# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# Check in license
arcpy.CheckInExtension('LocationReferencing')La siguiente secuencia de comandos independiente muestra cómo utilizar la función OverlayEvents con datos de un servicio de entidades.
# Name: OverlayEvents_Pro_Ex3.py
# Description: Overlay events using a feature service. It is recommended to work in a version and post to the default version.
# Requires: ArcGIS Location Referencing
# Import arcpy module
import arcpy
# Check out license
arcpy.CheckOutExtension("LocationReferencing")
#Input LRS network and events are in feature service. Portal sign in is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')
# Map the input LRS network and events from the feature service. Here, 1 corresponds to the input LRS network, while 2 and 3 corresponds to the input events.
in_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"
event1 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/2"
event2 = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"
in_events = [event1, event2]
# Set tool variables
Output_Dataset = r"C:\Data\LocationReferencing.gdb\output"
Geometry = "EXCLUDE_GEOMETRY"
Network_Fields = ""
Address_Block_Split_Type = ""
# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields, Address_Block_Split_Type)
# Check in license
arcpy.CheckInExtension('LocationReferencing')Entornos
Información de licenciamiento
- Basic: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
- Standard: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)
- Advanced: Requiere ArcGIS Location Referencing (ArcGIS Pipeline Referencing o ArcGIS Roads and Highways)