| Etiqueta | Explicación | Tipo 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).
| String |
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
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, {in_concurrent_route_matching})| Nombre | Explicación | Tipo 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).
| String |
Muestra de código
El siguiente script de la ventana de Python muestra cómo utilizar la herramienta TranslateEventMeasures en el modo inmediato en ArcGIS Pro:
# Name: TranslateEventMeasures_ex1.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
# Set current workspace
arcpy.env.workspace = r"C:\Data\Outputs.gdb"
# Tool variables
in_source_event = "TestPressureRange"
in_target_route_features = "StationSeriesNetwork"
out_target_event = "Test_Pressure_Range_Station_Series"
in_concurrent_route_matching = "ANY"
# Execute the tool
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)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:
in_source_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure"
in_target_route_features = r"C:\Data\Pipeline_Data.gdb\LRS\StationSeries"
out_target_event = r"C:\Data\Pipeline_Data.gdb\LRS\Pressure_Transform"
in_concurrent_route_matching = "ANY"
# Process: Translate Event Measures
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
# Check in license
arcpy.CheckInExtension('LocationReferencing')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.
in_source_event = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/31"
in_target_route_features = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/53"
# Set tool variables
out_target_event = r"C:\Data\LocationReferencing.gdb\outputevent"
in_concurrent_route_matching = "ANY"
# Process: Translate Event Measures.
arcpy.locref.TranslateEventMeasures(in_source_event, in_target_route_features, out_target_event, in_concurrent_route_matching)
# 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)