Traducir mediciones de evento (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Traduce las mediciones (valores m) de una capa de eventos de punto o línea de un método de referenciación lineal (LRM) a otro.

Un caso de uso para esta herramienta sería traducir los datos de eventos de una red basada en millas a una red basada en kilómetros.

Además de las mediciones, las asociaciones de ruta de las entidades de eventos también pueden ser diferentes entre los dos LRM. La salida de esta herramienta es una clase de entidad que contiene las mediciones y asociaciones de ruta correctas de la red LRS de destino.

Uso

  • La capa de eventos de entrada debe ser una clase de entidad de punto o línea.

  • Esta herramienta no modifica ninguna entrada y crea una clase de entidad como salida.

  • Esta herramienta es compatible con una representación temporal a la vez. Cree una consulta de definición basada en tiempo o aplique un conjunto de selección basada en tiempo a la capa de eventos de entrada y a la red LRS de destino antes de ejecutar esta herramienta. El control deslizante de tiempo de ArcGIS Pro también puede utilizarse si se configura el tiempo para ambas capas de entrada.

  • Esta herramienta admite la traducción de eventos con respecto a rutas con huecos.

  • Si la red de destino es una red de líneas LRS, también conocida como red de ingeniería, la capa de eventos de entrada se puede traducir, aunque la red original de la capa de eventos de entrada no admita el concepto de líneas.

  • El tipo de clase de entidad de salida, línea o punto, debe coincidir con el tipo de capa de eventos de entrada.

  • La configuración de tolerancia y resolución de la capa de eventos de entrada debe coincidir con los de la red LRS de destino.

  • Para identificar las condiciones de correspondencia que se producen durante la traducción, se crea un campo denominado Loc_Error en la clase de entidad de salida que contiene valores tales como Multi-Match, Partial Match, No Match y No Error.

  • Los campos de atributos de la clase de entidad de entrada no se incluyen en la clase de entidad de salida.

  • Si la red LRS de destino contiene rutas concurrentes, utilice la opción Concordancia de rutas concurrentes.

  • Si se utiliza Ruta con Id. de ruta coincidente con Concordancia de rutas concurrentes, la capa de eventos de entrada se debe registrar como una capa de eventos LRS en ArcGIS Location Referencing.

  • Esta herramienta realizará una superposición espacial de la capa de eventos de entrada en la red LRS de destino para generar entidades para el evento de entrada a lo largo de la red de destino. Estas entidades contendrán el Id. de ruta y la información de medición de esa ubicación en la ruta.

  • La capa de eventos de entrada y la red de destino solo deben representar un único punto en el tiempo para obtener una salida exacta. Si la capa de eventos de entrada representa varios puntos en el tiempo, establezca un filtro con el control deslizante de tiempo o utilice una consulta de definición en las columnas de fecha.

  • Los datos de salida se pueden agregar a un evento LRS nuevo o existente mediante la herramienta Incorporar eventos. Si la capa de eventos de entrada contenía varias representaciones temporales y provocó la ejecución de esta herramienta varias veces con filtros de fecha diferentes, cada una de las salidas se puede agregar a una única clase de entidad de evento LRS mediante Incorporar eventos.

Parámetros

EtiquetaExplicaciónTipo de datos
Capa de eventos de origen

La capa de eventos de entrada que se va a traducir.

Feature Layer
Entidades de ruta de destino de entrada

La red LRS de destino con respecto a la que se traducirán los eventos de entrada.

Feature Layer
Capa de eventos de salida

La clase de entidad de salida que contendrá las entidades de eventos de movimiento traducidos.

Feature Class
Concordancia de rutas concurrentes
(Opcional)

Especifica el método utilizado para determinar la ruta con respecto a la cual se debe traducir el evento cuando existen rutas concurrentes en la red LRS de destino. Este parámetro solo se aplica cuando la ubicación de la traducción del evento en la red LRS de destino tiene rutas concurrentes (rutas que comparten una ubicación).

  • Cualquier ruta concurrenteLa capa de eventos de entrada se traduce con respecto a la primera de dos o más rutas concurrentes que se encuentren en la red LRS de destino.
  • Ruta con RouteID coincidenteEl Id. de ruta del evento de origen se compara con los Id. de ruta de las rutas concurrentes en la red LRS de destino. El evento de origen se traducirá en función de las coincidencias de Id. de ruta en el evento de origen y la red de destino. Los Id. de ruta del evento de entrada y de la red LRS de destino deben ser una coincidencia exacta para que este método traduzca correctamente el evento. La capa de eventos de entrada también debe ser un evento LRS registrado para utilizar este método.
  • Todas las rutas concurrentesEl evento de entrada se traduce con respecto a todas las rutas concurrentes en esa ubicación en la red LRS de destino.
String

arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})
NombreExplicaciónTipo de datos
in_source_event

La capa de eventos de entrada que se va a traducir.

Feature Layer
in_target_route_features

La red LRS de destino con respecto a la que se traducirán los eventos de entrada.

Feature Layer
out_target_event

La clase de entidad de salida que contendrá las entidades de eventos de movimiento traducidos.

Feature Class
in_concurrent_route_matching
(Opcional)

Especifica el método utilizado para determinar la ruta con respecto a la cual se debe traducir el evento cuando existen rutas concurrentes en la red LRS de destino. Este parámetro solo se aplica cuando la ubicación de la traducción del evento en la red LRS de destino tiene rutas concurrentes (rutas que comparten una ubicación).

  • ANYLa capa de eventos de entrada se traduce con respecto a la primera de dos o más rutas concurrentes que se encuentren en la red LRS de destino.
  • ROUTE_IDEl Id. de ruta del evento de origen se compara con los Id. de ruta de las rutas concurrentes en la red LRS de destino. El evento de origen se traducirá en función de las coincidencias de Id. de ruta en el evento de origen y la red de destino. Los Id. de ruta del evento de entrada y de la red LRS de destino deben ser una coincidencia exacta para que este método traduzca correctamente el evento. La capa de eventos de entrada también debe ser un evento LRS registrado para utilizar este método.
  • ALLEl evento de entrada se traduce con respecto a todas las rutas concurrentes en esa ubicación en la red LRS de destino.
String

Muestra de código

Ejemplo de TranslateEventMeasures 1 (ventana de Python)

El siguiente script de la ventana de Python muestra cómo utilizar la herramienta TranslateEventMeasures en el modo inmediato en ArcGIS Pro:

# Name: TranslateEventMeasures_ex2.py
# Description: Translate the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing

# Tool variables
in_source_event = "Test Pressure Range"
in_target_route_features = "Station Series Network"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"

# Set current workspace
arcpy.env.workspace = "C:\Data\Outputs.gdb"

# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
Ejemplo de TranslateEventMeasures 2 (script independiente)

El siguiente script independiente muestra cómo utilizar la herramienta TranslateEventMeasures en ArcGIS Pro:

# Name: TranslateEventMeasures_ex2.py
# Description: Translates the measures (m-values) of events from one linear referencing method (LRM) to another. The output is a new event layer feature class.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

# Local variables:
Event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
Network = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
Output = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
Concurrency = "ANY"

# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(Event, Network, Output, Concurrency)

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

El siguiente script independiente muestra cómo utilizar la herramienta TranslateEventMeasures en un servicio de entidades:

# Name: TranslateEventMeasures_Pro_Ex3.py
# Description: Translate event measures in stand-alone mode using a feature service. It is recommended to work in a version and post to a default version.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

# Check out the license
arcpy.CheckOutExtension("LocationReferencing")

# Input event and target LRS network are in feature service.  Signing in portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Map the input event and target LRS network from the feature service. Here, 53 corresponds to the target LRS network and 31 corresponds to source event.
source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
target_route_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"

# Set tool variables
output_event = r"C:\Data\LocationReferencing.gdb\outputevent"
concurrency = "ANY"

# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(source_event, target_route_network, output_event, concurrency)

# 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