Generar puntos de calibración (Location Referencing)

Disponible con licencia de Location Referencing.

Resumen

Genera puntos de calibración para cualquier forma de ruta proporcionada, incluidas formas complejas como, por ejemplo, rutas de autocierre, autointersecantes y ramificadas.

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 .

  • El valor del parámetro Entidades de polilínea de entrada es la base para los puntos de calibración que se generarán.

  • El valor del parámetro Clase de entidad de punto de calibración debe estar registrado con el LRS.

  • El valor del parámetro Red LRS debe estar registrado con el LRS.

  • Las redes LRS derivadas no se admiten como valor del parámetro Red LRS.

  • Los valores z se tienen en cuenta al calcular la longitud geométrica de las líneas de centro.

  • Se seguirán las reglas de calibración de huecos mientras se generan puntos de calibración con las opciones Longitud de geometría y Campos de atributo para el parámetro Método de calibración.

    Más información sobre cómo calibrar rutas con huecos físicos en ArcGIS Roads and Highways o cómo calibrar rutas con huecos físicos en ArcGIS Pipeline Referencing.

  • Si el parámetro Método de calibración está establecido en M en la ruta, los valores m se utilizarán en vértice de inicio y el vértice final de las rutas de entrada para crear puntos de calibración iniciales y finales.

  • Cuando el parámetro Método de calibración se ha definido como Campos de atributos, ocurre lo siguiente:

    • La opción Campos de atributos se utilizará para evaluar campos con un tipo de campo Doble para la calibración.
    • El valor del parámetro Campo de medición inicial se utilizará para proporcionar la medición inicial de la ruta y el valor del parámetro Campo de medición final se utilizará para proporcionar la medición final de la ruta.
  • El valor del parámetro Entidades de polilíneas de entrada puede ser una capa de servicio de entidad que no tenga la función de referencia lineal. Si el valor del parámetro Clase de entidad de punto de calibración es una capa de servicio de entidad, debe tener la función de referencia lineal activada.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de polilínea de entrada

Las entidades que se utilizarán como origen para calcular los valores de medición de los puntos de calibración.

Feature Layer
Campo Id. de ruta

El campo que contiene los valores que identifican de manera única cada ruta. El tipo de campo debe coincidir con el campo Route ID de la clase de entidad de punto de calibración.

Field
Campo de fecha inicial

El campo que contiene los valores de fecha inicial de una ruta.

Field
Campo de fecha final

El campo que contiene los valores de fecha final de una ruta.

Field
Clase de entidad de punto de calibración

La clase de entidad de punto de calibración existente a la que se agregarán las nuevas entidades.

Feature Layer
Red LRS

La red LRS para la que se generarán los valores de medición en la clase de entidad de punto de calibración.

String
Dirección de calibración
(Opcional)

Especifica la dirección de aumento de la calibración de una ruta al crear puntos de calibración.

  • Dirección digitalizadaLa dirección de digitalización de la entidad de polilínea individual determina la dirección de la calibración de la ruta. Esta es la opción predeterminada.
  • Dirección de mediciónLa dirección de los valores m ascendentes de la entidad de polilínea individual determina la dirección de la calibración de la ruta.Si la entidad de polilínea individual no incluye valores m, se utilizará la dirección digitalizada.
String
Método de calibración
(Opcional)

Especifica el método que se utilizará para determinar las mediciones de una ruta al crear puntos de calibración.

  • Longitud de geometríaLa longitud geométrica de la entidad de ruta de entrada se utilizará como el método de calibración. Esta es la opción predeterminada.
  • M en la rutaLos valores de medición de la entidad de ruta de entrada se utilizarán como el método de calibración.
  • Campos de atributoLos valores de medición almacenados en los campos de atributo de la entidad de ruta de entrada se utilizarán como el método de calibración.
String
Campo de medición inicial
(Opcional)

El campo que contiene la medición inicial de la ruta seleccionada.

Este parámetro está activo si el parámetro Método de calibración está establecido en Campos de atributo.

Field
Campo de medición final
(Opcional)

El campo que contiene la medición final de la ruta seleccionada.

Este parámetro está activo si el parámetro Método de calibración está establecido en Campos de atributo.

Field

Salida derivada

EtiquetaExplicaciónTipo de datos
Clase de entidad de punto de calibración actualizada

Las entidades de calibración actualizadas.

Feature Layer
Archivo de detalles de salida

Archivo de texto que detalla los cambios realizados por la herramienta.

Text File

arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, {calibration_direction}, {calibration_method}, {from_measure_field}, {to_measure_field})
NombreExplicaciónTipo de datos
in_polyline_features

Las entidades que se utilizarán como origen para calcular los valores de medición de los puntos de calibración.

Feature Layer
route_id_field

El campo que contiene los valores que identifican de manera única cada ruta. El tipo de campo debe coincidir con el campo Route ID de la clase de entidad de punto de calibración.

Field
from_date_field

El campo que contiene los valores de fecha inicial de una ruta.

Field
to_date_field

El campo que contiene los valores de fecha final de una ruta.

Field
in_calibration_point_feature_class

La clase de entidad de punto de calibración existente a la que se agregarán las nuevas entidades.

Feature Layer
lrs_network

La red LRS para la que se generarán los valores de medición en la clase de entidad de punto de calibración.

String
calibration_direction
(Opcional)

Especifica la dirección de aumento de la calibración de una ruta al crear puntos de calibración.

  • DIGITIZED_DIRECTIONLa dirección de digitalización de las entidades de polilínea individual determina la dirección de la calibración de la ruta. Esta es la opción predeterminada.
  • MEASURE_DIRECTIONLa dirección de los valores m ascendentes de la entidad de polilínea individual determina la dirección de la calibración de la ruta.Si la entidad de polilínea individual no incluye valores m, se utilizará la dirección digitalizada.
String
calibration_method
(Opcional)

Especifica el método que se utilizará para determinar las mediciones de una ruta al crear puntos de calibración.

  • GEOMETRY_LENGTHLa longitud geométrica de la entidad de ruta de entrada se utilizará como el método de calibración. Esta es la opción predeterminada.
  • M_ON_ROUTELos valores de medición de la entidad de ruta de entrada se utilizarán como el método de calibración.
  • ATTRIBUTE_FIELDSLos valores de medición almacenados en los campos de atributo de la entidad de ruta de entrada se utilizarán como el método de calibración.
String
from_measure_field
(Opcional)

El campo que contiene la medición inicial de la ruta seleccionada.

Este parámetro está habilitado cuando el parámetro calibration_method tiene el valor ATTRIBUTE_FIELDS.

Field
to_measure_field
(Opcional)

El campo que contiene la medición final de la ruta seleccionada.

Este parámetro está habilitado cuando el parámetro calibration_method tiene el valor ATTRIBUTE_FIELDS.

Field

Salida derivada

NombreExplicaciónTipo de datos
out_calibration_point_feature_class

Las entidades de calibración actualizadas.

Feature Layer
out_details_file

Archivo de texto que detalla los cambios realizados por la herramienta.

Text File

Muestra de código

Ejemplo 1 de GenerateCalibrationPoints (ventana de Python)

En el siguiente script de la ventana de Python se muestra cómo utilizar la función GenerateCalibrationPoints en la ventana de Python.

# Name: GenerateCalibrationPoints_ex1.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in Python window.
# Requires: ArcGIS Location Referencing

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

# Generate Calibration Points tool variables:
in_polyline_features = "SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = "Calibration_Point"
lrs_network = "NonLineNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Execute Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)
Ejemplo 2 de GenerateCalibrationPoints (script independiente)

El siguiente script independiente muestra cómo utilizar la función GenerateCalibrationPoints.

# Name: GenerateCalibrationPoints_ex2.py
# Description: Build calibration point features when an LRS already exists in the geodatabase in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
in_calibration_point_feature_class = r"C:\\Data\UPDM.gdb\LRS\Calibration_Point"
lrs_network = "EngineeringNetwork"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)

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

El siguiente script independiente muestra cómo utilizar la función GenerateCalibrationPoints para crear puntos de calibración en un servicio de entidades existente.

# Name: GenerateCalibrationPoints_ex3.py
# Description: Build calibration point features in an existing feature service in a stand-alone script.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Input LRS route network and calibration point feature class are in feature service.  Signing into portal is required to access the feature service.
arcpy.SignInToPortal('https://yourdomain.com/portal', 'username', 'password')

# Generate Calibration Points tool variables:
in_polyline_features = r"C:\Data\SourceData.gdb\LRS\SourceRoutes"
route_id_field = "RouteID"
from_date_field = "FromDate"
to_date_field = "ToDate"
calibration_direction = "MEASURE_DIRECTION"
calibration_method = "GEOMETRY_LENGTH"

# Map the LRS Network and Calibration Point feature class from the feature service. Here, 5 corresponds to the LRS Network and 1 corresponds to the Calibration Point feature class.
lrs_network = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/5"
in_calibration_point_feature_class = r"https://yourdomain.com/server/rest/services/FeatureServiceName/FeatureServer/1"

# Process: Generate Calibration Points
arcpy.locref.GenerateCalibrationPoints(in_polyline_features, route_id_field, from_date_field, to_date_field, in_calibration_point_feature_class, lrs_network, calibration_direction, calibration_method)
                                                         
## Check in license
arcpy.CheckInExtension('LocationReferencing')

Entornos

Casos especiales

Factor de procesamiento en paralelo

El valor predeterminado de este entorno, si se deja en blanco, es 0%. Cualquier valor absoluto del entorno siempre se fija entre 0 y el número de núcleos lógicos de esa máquina.

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