Actualizar mediciones de LRS (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Rellena o actualiza las mediciones y el Id. de ruta de entidades de Utility Network (UN), tales como tuberías, dispositivos y cruces, o de entidades de clases de entidad que no sean clases de entidad UN o LRS.

Esta herramienta busca rutas adecuadas del parámetro Red LRS, obtiene las mediciones de esa ruta y rellena o actualiza los atributos de medición y ruta para las entidades de la clase de entidad que no es LRS.

Nota:

Se requiere la extensión ArcGIS Pipeline Referencing Server o ArcGIS Roads and Highways Server para utilizar esta herramienta al utilizar datasets de un servicio de entidades.

Uso

• A partir de ArcGIS Pro 3.0, esta herramienta admite la conexión directa (conexión de cliente y servidor) mediante el versionado en rama, así como la conexión admitida anteriormente a través de un servicio de entidades mediante el versionado en rama.

• Las propiedades de los campos de los parámetros Entidades de entrada y Red LRS deben coincidir.

• La referencia espacial, la resolución x,y y la tolerancia x,y de los parámetros Entidades de entrada y Red LRS deben coincidir.

• Se escribe un registro de texto localmente que indica que la herramienta se ejecutó y contiene lo siguiente:

  • Información sobre las entidades de entrada que no superaron la validación
  • El Id. de ruta y los valores de medición de las entidades de entrada actualizadas anteriores y posteriores a la actualización

• El valor de Entidades de entrada debe coincidir exactamente con las entidades de Red LRS.

  Los siguientes diagramas y tablas muestran cómo se actualizarán las entidades de línea y punto de los valores de Entidades de entrada que no son clases de entidad LRS, pero que coinciden con la Ruta1 en las entidades de Red LRS:

  

  Capa de entrada	Tipo de entidad	ID de ruta	Medición Inicial	Medición Final	Comentarios
  Capa de entrada no LRS	Línea	Ruta1	11	18	La geometría de la entidad de línea tiene una coincidencia geométrica con la red LRS.

  

  Capa de entrada	Tipo de entidad	ID de ruta	Medición Inicial	Medición Final	Comentarios
  Capa de entrada no LRS	Punto	Ruta1	21		La entidad de punto coincide con la ruta en el valor de Red LRS.

  

  Capa de entrada	Tipo de entidad	ID de ruta	Medición Inicial	Medición Final	Comentarios
  Capa de entrada no LRS	Línea				La geometría de la entidad de línea no coincide con la red de entrada. No se devuelve ninguna información.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Red LRS	La capa de entidades que contiene las rutas, los Id. de ruta y las mediciones.	Feature Layer
Fecha de LRS	La fecha utilizada para definir la vista temporal de la red para recopilar los valores de ruta y medición.	Date
Entidades de entrada	La capa que incluye los campos de Id. de ruta y medición que se actualizarán en función de la geometría de entidad en relación con las rutas del parámetro Red LRS.	Feature Layer
Campo Id. de ruta	El campo de la capa Entidades de entrada que contiene el valor de Id. de ruta.	Field
Campo de medición	El campo de la capa Entidades de entrada que contiene el valor de medición inicial para entidades de polilínea.	Field
Campo de medición final (Opcional)	El campo de la capa Entidades de entrada que contiene el valor de medición para entidades de punto o el valor de medición final para entidades de polilínea.	Field

Salida derivada

Etiqueta	Explicación	Tipo de datos
Archivo de detalles de salida	El archivo de registro de salida que muestra las entidades actualizadas del parámetro Entidades de entrada. Este archivo de registro incluirá los valores anteriores y posteriores de los campos de Id. de ruta, medición inicial y medición final para cada entidad actualizada.	Text File
Entidades de salida	Capa de entidades actualizada. 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.	Feature Layer

Python

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field})

Nombre	Explicación	Tipo de datos
lrs_network	La capa de entidades que contiene las rutas, los Id. de ruta y las mediciones.	Feature Layer
lrs_date	La fecha utilizada para definir la vista temporal de la red para recopilar los valores de ruta y medición.	Date
in_features	La capa que incluye los campos de Id. de ruta y medición que se actualizarán en función de la geometría de entidad en relación con las rutas del parámetro lrs_network.	Feature Layer
route_id_field	El campo de la capa in_features que contiene el valor de Id. de ruta.	Field
from_measure_field	El campo de la capa in_features que contiene el valor de medición inicial para entidades de polilínea.	Field
to_measure_field (Opcional)	El campo de la capa in_features que contiene el valor de medición para entidades de punto o el valor de medición final para entidades de polilínea.	Field

Salida derivada

Nombre	Explicación	Tipo de datos
out_details_file	El archivo de registro de salida que muestra las entidades actualizadas del parámetro in_features. Este archivo de registro incluirá los valores anteriores y posteriores de los campos de Id. de ruta, medición inicial y medición final para cada entidad actualizada.	Text File
out_features	Capa de entidades actualizada. 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.	Feature Layer

Muestra de código

Ejemplo 1 de UpdateMeasuresFromLRS (ventana de Python)

Esta muestra de código presenta cómo utilizar la función UpdateMeasuresFromLRS en la ventana de Python.

# Name: UpdateMeasuresFromLRS_Sample1.py
# Description: This will populate the Route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated Route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing

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

## Variables are supported from feature service only. Signing into Portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables

# Map the lrs network from the feature service. Here, 8 corresponds to the lrs route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date="10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field)

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

Ejemplo 2 de UpdateMeasuresFromLRS (script independiente)

Esta muestra de código presenta cómo utilizar la función UpdateMeasuresFromLRS como un script independiente de Python en un servicio de entidades.

# Name: UpdateMeasuresFromLRS_Sample2.py
# Description: Populate the route ID and measures in the input layer based on overlapping routes from the network layer. 
# The output is the input layer with the updated route ID and measure values, and a .csv file with information on the updated features and errors.
# Requires: ArcGIS Location Referencing
 
# Import arcpy module
import arcpy
 
# Check out license
arcpy.CheckOutExtension("LocationReferencing")

## Variables are supported from feature service only. Portal signin is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Initialize variables
# Map the lrs network from the feature service. Here, 8 corresponds to the LRS route network.
lrs_network_url =  r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/8"
lrs_network = arcpy.management.MakeFeatureLayer(lrs_network_url, "networkLayer")

# Map the input feature layer from the same feature service. Here, 18 corresponds to the input feature layer.
in_features_url = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/18"
in_features = arcpy.management.MakeFeatureLayer(in_features_url, "inputFeaturesLayer")
lrs_date="10/8/2019"
route_id_field = "ROUTEID"
from_measure_field = "FROMMEASURE"
to_measure_field = "TOMEASURE"

# Execute the tool
arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, to_measure_field)

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

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

• Basic: Requiere ArcGIS Location Referencing
• Standard: Requiere ArcGIS Location Referencing
• Advanced: Requiere ArcGIS Location Referencing