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. Para crear un dataset de LRS, agregue las capas de punto de calibración, línea de centro y marcado a un dataset de entidades y, a continuación, ejecute la herramienta Modificar LRS con la geodatabase como entrada.

• 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, la herramienta utilizará los valores m del vértice de inicio y el vértice final de las rutas de entrada para crear puntos de calibración iniciales y finales.

• Si el parámetro Método de calibración se ha definido como Campos de atributo, la herramienta hará lo siguiente:

  • Evaluar los campos con un tipo de campo Doble para la calibración utilizando el método Campos de atributo.
  • Utilizar el valor del parámetro Campo de medición inicial para proporcionar la medición inicial de la ruta y el valor del parámetro Campo de medición final para proporcionar la medición final de la ruta.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo 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 digitalizada—La dirección de digitalización del valor del parámetro Entidades de polilínea de entrada determina la dirección de calibración de la ruta. Esta es la opción predeterminada. Dirección de medición—La dirección de aumento de los valores m del valor del parámetro Entidades de polilínea de entrada determina la dirección de calibración de la ruta.Si el valor del parámetro Entidades de polilínea de entrada no incluye valores m, se utilizará en su lugar 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ía—La 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 ruta—Los valores de medición de la entidad de ruta de entrada se utilizarán como el método de calibración. Campos de atributo—Los 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

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

Python

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})

Nombre	Explicación	Tipo 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 nuevos puntos de calibración. DIGITIZED_DIRECTION—La dirección de digitalización del valor del parámetro in_polyline_features determina la dirección de la calibración de la ruta. Esta es la opción predeterminada. MEASURE_DIRECTION—La dirección de aumento de los valores m del valor del parámetro in_polyline_features determina la dirección de calibración de la ruta.Si el valor del parámetro in_polyline_features no incluye valores m, se utilizará en su lugar 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_LENGTH—La 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_ROUTE—Los valores de medición de la entidad de ruta de entrada se utilizarán como el método de calibración. ATTRIBUTE_FIELDS—Los 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 inicial de la ruta seleccionada. Este parámetro está habilitado cuando el parámetro calibration_method tiene el valor ATTRIBUTE_FIELDS.	Field

Salida derivada

Nombre	Explicación	Tipo 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.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# 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"

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

# 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.py
# Description: Build calibration point features when an LRS already exists in the geodatabase.
# Requires: ArcGIS Location Referencing

# Import arcpy module
import arcpy

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

# Local 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')

Entornos

Espacio de trabajo actual, Factor de procesamiento en paralelo

Casos especiales

Factor de procesamiento en paralelo

El valor predeterminado de este entorno, si se deja en blanco, es 100%. 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
• Standard: Requiere ArcGIS Location Referencing
• Advanced: Requiere ArcGIS Location Referencing