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:

    Ejemplo de actualización de mediciones de Id. de ruta mediante una entidad de línea

    Capa de entradaTipo de entidadID de rutaMedición InicialMedición FinalComentarios

    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.

    Ejemplo de actualización de mediciones de Id. de ruta mediante una entidad de punto

    Capa de entradaTipo de entidadID de rutaMedición InicialMedición FinalComentarios

    Capa de entrada no LRS

    Punto

    Ruta1

    21

    La entidad de punto coincide con la ruta en el valor de Red LRS.

    Ejemplo de mediciones de Id. de ruta que no se pueden actualizar porque la entidad de línea no coincide exactamente con la red LRS

    Capa de entradaTipo de entidadID de rutaMedición InicialMedición FinalComentarios

    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

EtiquetaExplicaciónTipo 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

EtiquetaExplicaciónTipo 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

arcpy.locref.UpdateMeasuresFromLRS(lrs_network, lrs_date, in_features, route_id_field, from_measure_field, {to_measure_field})
NombreExplicaciónTipo 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

NombreExplicaciónTipo 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

Temas relacionados