Eventos de superposición (Location Referencing)

ArcGIS Pro 3.4 | | Archivo de ayuda

Disponible con licencia de Location Referencing.

Resumen

Superpone una o más capas de eventos de línea y de punto en una red de destino y genera una clase de entidad o tabla que representa la segmentación dinámica de las entradas.

Ilustración

Ilustración de la herramienta Eventos de superposición

Uso

  • La tabla siguiente es el resultado de la ilustración de la herramienta anterior:

    Salida (Eventos de superposición)

    TipoMedición InicialMedición FinalEvento de línea 1Evento de línea 2Evento de punto

    Línea

    0

    2

    A

    1

    <Nulo>

    Punto

    2

    2

    A

    1

    PE1

    Línea

    2

    3

    A

    1

    <Nulo>

    Línea

    3

    4

    B

    1

    <Nulo>

    Línea

    4

    5

    B

    2

    <Nulo>

  • Todos los valores de Capas de eventos pueden ser solo eventos de línea o pueden incluir eventos de puntos y de línea.

  • El parámetro Capas de eventos solo puede incluir clases de entidad de eventos registradas en una red de ArcGIS Location Referencing.

    Nota:

    La capa de línea de centro puede ser la entrada para el parámetro Capas de eventos para segmentar los eventos dinámicamente cuando la capa de línea de centro forma parte de una configuración de la solución Administración de datos de direcciones o de Utility Network. La dirección de la línea de centro se respeta en las salidas cuando la capa de línea de centro forma parte de una configuración de la solución Administración de datos de direcciones.

  • Si la capa de entrada tiene campos de rango de direcciones de una configuración de Administración de datos de direcciones y se configura como una clase de entidad de dirección en LRS, los valores de los campos de rango de direcciones se actualizarán para cada segmento de la salida.

  • Si los eventos de entrada utilizan métodos de referenciación lineal (LRM) diferentes, se traducirán con el LRM de la red de destino.

  • Esta herramienta admite conjuntos de selección en los valores de los parámetros Entidades de ruta de entrada y Capas de eventos.

  • Esta herramienta admite filtros de definición en los valores de los parámetros Entidades de ruta de entrada y Capas de eventos.

  • Esta herramienta admite valores de Capas de eventos de entrada configurados para contener eventos que abarquen varias rutas. La salida seguirá segmentando dinámicamente en el nivel de ruta de la red de destino utilizando el valor del parámetro Campos de red.

  • Esta herramienta admite la segmentación temporal (creación de intervalos de tiempo). Esto ocurrirá de forma predeterminada y se puede invalidar 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 varios campos de la clase de entidad de red en la salida mediante el parámetro Campos de red.

  • La salida se puede guardar como tabla o como clase de entidad.

  • Si se guarda como una tabla o una clase de entidad, la salida tendrá los siguientes índices y campos:

    ÍndiceCampo

    Route_ID

    • Route_ID

    Rid_Dates_Me

    • Route_ID
    • From_Date
    • To_Date
    • From_Measure
    • To_Measure

  • Esta herramienta admite la capa de entidades de canalizaciones de la configuración Red de servicios de gas como capa de eventos de entrada si esta clase de entidad se ha configurado para su uso con un LRS mediante la herramienta Configurar clase de entidad de red de servicios.

  • Si existe más de una red LRS en la configuración Red de servicios de gas, las mediciones de las capas de eventos de entrada coincidirán con las mediciones que se muestran en la segunda columna de la tabla siguiente:

    Si el LRS con Utility Network Configuration contieneLas mediciones de la clase de entidad PipelineLine pertenecen a

    Red de líneas, red sin líneas

    Red de líneas

    Red de líneas

    Red de líneas

    Más de una red de líneas

    Red de líneas con la red derivada

    Más de una red de líneas sin red derivada

    Red de líneas con el número más bajo del dominio de valor codificado, dLRSNetworks

    Más de una red de líneas con redes derivadas

    Red de líneas con el número más bajo del dominio de valor codificado, dLRSNetworks

    Una red sin líneas

    Red sin líneas

    Más de una red sin líneas

    Red con el número más bajo del dominio de valor codificado, dLRSNetworks

  • Esta herramienta admite rutas y eventos escalonados físicamente como rutas de entrada y eventos de entrada, respectivamente.

  • Solo puede haber un evento por capa en un segmento de ruta. Por ejemplo, para la capa llamada Límite de velocidad, solo puede haber un registro de evento de la capa en ese segmento. Un segmento puede tener varios eventos, cada uno en su propia capa de eventos. Utilice la casilla de verificación Mediciones de evento no válidas de ArcGIS Data Reviewer para identificar y resolver problemas con datos de eventos.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de ruta de entrada

La red de destino en la que se segmentarán dinámicamente las capas de eventos.

Feature Layer
Capas de eventos

Las capas de eventos que se segmentarán juntas dinámicamente en una red de destino. La capa de línea central puede utilizarse como entrada para segmentar los eventos dinámicamente.

Feature Layer
Dataset de salida

La 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.

  • Desactivado: el valor del parámetro Dataset de salida no incluirá geometría de eventos. Los registros de eventos se almacenarán como una tabla. Esta es la opción predeterminada.
  • Activado: el valor del parámetro Dataset de salida incluirá geometría de eventos. Los registros de eventos se almacenarán como una clase de entidad.
Boolean
Campos de red
(Opcional)

Los campos de la capa de red que se incluirán en la salida.

Field

arcpy.locref.OverlayEvents(in_route_features, event_layers, output_dataset, {include_geometry}, {network_fields})
NombreExplicaciónTipo de datos
in_route_features

La red de destino en la que se segmentarán dinámicamente las capas de eventos.

Feature Layer
event_layers
[event_layers,...]

Las capas de eventos que se segmentarán juntas dinámicamente en una red de destino. La capa de línea central puede utilizarse como entrada para segmentar los eventos dinámicamente.

Feature Layer
output_dataset

La 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.

  • EXCLUDE_GEOMETRYEl valor del parámetro output_dataset no incluirá geometría de eventos. Los registros de eventos se almacenarán como una tabla. Esta es la opción predeterminada.
  • INCLUDE_GEOMETRYEl valor del parámetro output_dataset incluirá geometría de eventos. Los registros de eventos se almacenarán como una clase de entidad.
Boolean
network_fields
[network_fields,...]
(Opcional)

Los campos de la capa de red que se incluirán en la salida.

Field

Muestra de código

Ejemplo 1 de OverlayEvents (ventana de Python)

El siguiente script 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 = ""

# 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)
Ejemplo 2 de OverlayEvents (script independiente)

El siguiente script de Python muestra cómo utilizar la función OverlayEvents en un script 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 = ""

# Process: Overlay Events
arcpy.locref.OverlayEvents(Network, Events, Output_Dataset, Geometry, Network_Fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')
Ejemplo 3 de OverlayEvents (script independiente)

El siguiente script independiente muestra cómo utilizar la función OverlayEvents en 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 signi 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 and 2 and 3 corresponds to 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 = ""

# Process: Overlay Events.
arcpy.locref.OverlayEvents(in_network, in_events, Output_Dataset, Geometry, Network_Fields)

# Check in license
arcpy.CheckInExtension('LocationReferencing')

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)

Temas relacionados