Derivar mediciones de evento (Location Referencing)

Resumen

Rellena y actualiza el campo DerivedRouteID y los valores de medición en los eventos de punto y línea con esos campos configurados y habilitados.

Uso

  • Se requiere una licencia de LRS para ejecutar esta herramienta.

    Encontrará más información acerca de crear un dataset LRS en ArcGIS Pipeline Referencing o crear un dataset LRS en ArcGIS Roads and Highways .

  • Esta herramienta está diseñada para ejecutarse como parte de un flujo de trabajo más grande. Ejecute las herramientas Aplicar comportamientos de evento y Generar rutas antes de ejecutar Derivar mediciones de eventos. Ejecutar esta herramienta sin ejecutar las herramientas anteriores en el flujo de trabajo puede dar lugar a datos inexactos.

  • Se recomienda que ejecute esta herramienta en la geodatabase de archivos en la migración inicial de los datos. Se ejecutará más rápido de esta forma, ya que la operación debe modificar cada registro de eventos en la base de datos. Una vez en producción, la herramienta se puede ejecutar en un conjunto de selección de las rutas que se han modificado para mejorar significativamente el tiempo de rendimiento.

  • La capa de entidades de eventos de entrada debe tener DerivedRouteID y los campos de medición configurados.

  • Esta herramienta se puede ejecutar en uno, varios o todos los eventos de una red de líneas.

  • Esta herramienta admite la prevención de conflictos e intentará adquirir y transferir bloqueos.

  • Cuando se habilita la prevención de conflictos, se admite lo siguiente:

    • Los eventos cuyas mediciones de evento derivadas se deban actualizar adquirirán automáticamente bloqueos de evento, si están disponibles. Si no se pueden adquirir bloqueos, la herramienta fallará y proporcionará el archivo de texto de esos bloqueos.

      Puede obtener más información sobre la prevención de conflictos en Pipeline Referencing o la prevención de conflictos en Roads and Highways.

    • Al trabajar en la versión predeterminada, los bloqueos adquiridos se liberan automáticamente cuando la herramienta finaliza.
    • Al trabajar en una versión secundaria, los bloqueos adquiridos permanecerán en el estado de publicación cuando se complete la herramienta. El usuario debe publicar o eliminar la versión para liberar los bloqueos.
    • Mientras trabaja en una versión secundaria, si la ejecución de la herramienta se cancela por interrupción, los bloqueos adquiridos permanecerán en estado liberable.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de ruta de entrada

Red LRS que contiene los eventos con DerivedRouteID y los campos de medición configurados.

Feature Layer
Actualizar todas las clases de entidad de evento registradas en la red seleccionada
(Opcional)

Especifica si se actualizarán todas las clases de entidad de evento de la red.

  • Activado: se actualizarán todas las clases de entidad de evento de la red seleccionada en el valor del parámetro Entidades de ruta de entrada. Esta es la opción predeterminada.
  • Desactivado: no se actualizarán todas las clases de entidad de evento de la red seleccionada en el valor del parámetro Entidades de ruta de entrada. Las capas de eventos individuales se pueden seleccionar mediante el parámetro Capas de eventos.
Boolean
Capas de eventos
(Opcional)

Capas de eventos en las que DerivedRouteID y los campos de medida se actualizarán.

Feature Layer

Salida derivada

EtiquetaExplicaciónTipo de datos
Eventos de salida

Capa de entidades de evento actualizada.

Feature Layer
Archivo de detalles de salida

Archivo de texto que detalla los cambios realizados en la capa de entidades de evento.

Nota:

Los resultados de la validación de esta herramienta se escriben en el directorio de ArcGIS Server. Este archivo se limpia automáticamente en 10 minutos por defecto, lo que puede no ser suficiente tiempo para procesar todas las validaciones y escribirlas en su estación de trabajo que se está ejecutando ArcGIS Pro. Para cargas de datos mayores, se recomienda ajustar la antigüedad máxima del archivo a una hora como mínimo.

Text File

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})
NombreExplicaciónTipo de datos
in_route_features

Red LRS que contiene los eventos con DerivedRouteID y los campos de medición configurados.

Feature Layer
update_all_events
(Opcional)

Especifica si se actualizarán todas las clases de entidad de evento de la red.

  • UPDATE_ALLSe actualizarán todas las clases de entidad de evento de la red seleccionada en el valor de parámetro in_route_features. Esta es la opción predeterminada.
  • UPDATE_SOMENo se actualizarán todas las clases de entidad de evento de la red seleccionada en el valor de parámetro in_route_features. Las capas de eventos individuales se pueden seleccionar con el parámetro event_layers.
Boolean
event_layers
[event_layers,...]
(Opcional)

Capas de eventos en las que DerivedRouteID y los campos de medida se actualizarán.

Feature Layer

Salida derivada

NombreExplicaciónTipo de datos
out_events

Capa de entidades de evento actualizada.

Feature Layer
out_details_file

Archivo de texto que detalla los cambios realizados en la capa de entidades de evento.

Nota:

Los resultados de la validación de esta herramienta se escriben en el directorio de ArcGIS Server. Este archivo se limpia automáticamente en 10 minutos por defecto, lo que puede no ser suficiente tiempo para procesar todas las validaciones y escribirlas en su estación de trabajo que se está ejecutando ArcGIS Pro. Para cargas de datos mayores, se recomienda ajustar la antigüedad máxima del archivo a una hora como mínimo.

Text File

Muestra de código

Ejemplo 1 de DeriveEventMeasures (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar DeriveEventMeasures en el modo inmediato.

# Name: DeriveEventMeasures_ex1.py
# Description: Populate and update the Derived RouteID and measure values on point and line events with those fields configured and enabled.
# Requires: ArcGIS Location Referencing

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

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

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)
Ejemplo 2 de DeriveEventMeasures (script independiente)

El siguiente script independiente de Python muestra cómo utilizar la función DeriveEventMeasures.

# Name: DeriveEventMeasures_ex2.py
# Description: Populate and update the Derived routeID and measure values on point and line events with those fields configured and enabled.
# Requirements: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local variables
in_route_features = r'C:\Data\PipelineReferencing.gdb\LRS\LineNetwork'
update_all_events = "UPDATE_ALL"
event_layers = ""

# Execute the tool
arcpy.locref.DeriveEventMeasures(in_route_features, update_all_events, event_layers)

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

El siguiente script independiente de Python muestra cómo utilizar la función DeriveEventMeasures en un servicio de entidades.

# Name: DeriveEventMeasures_Pro_Ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled.
# Requires: ArcGIS Location Referencing

# Import arcpy module.
import arcpy

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

## Input LRS Route Network is in feature service. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

## Map the input route network from the feature service. Here, 3 corresponds to the input route network.
in_lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/3"

# Set tool variables.
update_all_events = "UPDATE_ALL"
event_layers = ""

# Process : Derive Event Measures.
arcpy.locref.DeriveEventMeasures(in_lrs_network, update_all_events, event_layers)

# 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