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 el campo DerivedRouteID y los campos de medición configurados.

• Los conjuntos de selección de la capa de entidades de ruta de entrada se respetan.

• Los conjuntos de selección de las capas de eventos se ignoran y no se respetan.

• 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

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de ruta de entrada	Red LRS que contiene los eventos con el campo 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 que se seleccionan 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 que se seleccionan 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 el campo DerivedRouteID y los campos de medida se actualizarán.	Feature Layer

Salida derivada

Etiqueta	Explicación	Tipo 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

Python

arcpy.locref.DeriveEventMeasures(in_route_features, {update_all_events}, {event_layers})

Nombre	Explicación	Tipo de datos
in_route_features	Red LRS que contiene los eventos con el campo 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_ALL—Se actualizarán todas las clases de entidad de evento de la red que se seleccionan en el valor del parámetro in_route_features. Esta es la opción predeterminada. UPDATE_SOME—No se actualizarán todas las clases de entidad de evento de la red que se seleccionan en el valor del 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 el campo DerivedRouteID y los campos de medida se actualizarán.	Feature Layer

Salida derivada

Nombre	Explicación	Tipo 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)

La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función DeriveEventMeasures de 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 in Python window.
# Requires: ArcGIS Location Referencing

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

# Local variables
in_route_features = "LineNetwork"
update_all_events = "UPDATE_SOME"
event_layers = "Casing, Coating"

# 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 in stand-alone script.
# 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 de DeriveEventMeasures en un servicio de entidades.

# Name: DeriveEventMeasures_ex3.py
# Description: Populate and update Derived RouteID and measure values on point and line events with those fields configured and enabled in stand-alone script.
# 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_route_features = 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_route_features, update_all_events, event_layers)

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

Entornos

Espacio de trabajo actual

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)