Calibrar rutas (Referenciación lineal)—ArcGIS Pro

Resumen

Recalcula las mediciones de ruta mediante puntos.

Uso

Se pueden calibrar rutas en forma total o parcial. Puede interpolar entre puntos de entrada, extrapolar antes de los puntos de entrada, extrapolar tras los puntos de entrada, o utilizar cualquier combinación de estos métodos.
Utilice la herramienta Crear capa de entidades o Crear tabla de consulta para reducir las rutas que se calibrarán.
Si el valor del parámetro Clase de entidad de rutas de salida se escribirá en una geodatabase, establezca los entornos Tolerancia M, Resolución M y Dominio M.
El valor del parámetro Clase de entidad de rutas de salida incluirá todos los campos del valor del parámetro Entidades de ruta de entrada.
La configuración del entorno La salida tiene valores M se ignora. El valor del parámetro Clase de entidad de ruta de salida tendrá valores m (valores de medición).
No se puede especificar un radio de búsqueda de infinidad.
Un índice de atributos en el campo identificador de rutas acelera el proceso de segmentación dinámica. Si va a utilizar el valor del parámetro Clase de entidad de rutas de salida para la segmentación dinámica, se recomienda que cree un índice de atributos.
Si esta herramienta rechaza entidades, se crea un archivo de texto en la ruta de archivo temporal para almacenar información sobre esas entidades, por ejemplo, C:\Users\patrickb\AppData\Local\Temp\Calibrate_Output0.txt (donde Calibrate_Output es el nombre del valor del parámetro Clase de entidad de ruta de salida).

Parámetros

Etiqueta	Explicación	Tipo de datos
Entidades de ruta de entrada	Las entidades de ruta que se calibrarán.	Feature Layer
Campo Identificador de rutas	El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID.	Field
Entidades de puntos de entrada	Las entidades de punto que se utilizarán para calibrar las rutas.	Feature Layer
Campo de identificador de puntos	El campo que identifica la ruta en la que se ubica cada punto de calibración. Los valores de este campo coinciden con aquellos del campo de identificador de rutas. Este campo puede ser un campo numérico, de texto o GUID.	Field
Campo de medición	El campo que contiene el valor de medición para cada punto de calibración. Este campo debe ser numérico.	Field
Clase de entidad de ruta de salida	La clase de entidad que se va a crear. Puede ser una clase de entidad de shapefile o de geodatabase.	Feature Class
Método del cálculo de medición (Opcional)	Especifica cómo se volverán a calcular las mediciones de ruta. Distancia—Las mediciones se volverán a calcular mediante la distancia de ruta más corta entre los puntos de calibración. Esta es la opción predeterminada. Medidas—Las mediciones se volverán a calcular mediante la distancia de medida preexistente entre los puntos de calibración.	String
Radio de búsqueda (Opcional)	Limita la distancia a la que puede estar un punto de calibración de una ruta al especificar la distancia y su unidad de medida. Si se desconoce la unidad de medida, se usarán las unidades del sistema de coordenadas de la clase de entidad de ruta.	Linear Unit
Interpolar entre puntos de calibración (Opcional)	Especifica si los valores de medición se interpolarán entre los puntos de calibración. Activado: los valores de medición se interpolarán entre los puntos de calibración. Esta es la opción predeterminada. No activado: los valores de medición no se interpolarán entre los puntos de calibración.	Boolean
Extrapolar antes de los puntos de calibración (Opcional)	Especifica si los valores de medición se extrapolarán antes de los puntos de calibración. Activado: los valores de medición se extrapolarán antes de los puntos de calibración. Esta es la opción predeterminada. No activado: los valores de medición no se extrapolarán antes de los puntos de calibración.	Boolean
Extrapolar después de los puntos de calibración (Opcional)	Especifica si los valores de medición se extrapolarán después de los puntos de calibración. Activado: los valores de medición se extrapolarán después de los puntos de calibración. Esta es la opción predeterminada. No activado: los valores de medición no se extrapolarán después de los puntos de calibración.	Boolean
Ignorar espacios (Opcional)	Especifica si se ignorarán los espacios cuando se vuelvan a calcular las medidas de las rutas inconexas. Activado: se ignoran los espacios. Los valores de medición serán continuos para las rutas inconexas. Esta es la opción predeterminada. No activado: no se ignoran los espacios. Los valores de medición de las rutas inconexas tendrán espacios. La distancia del espacio se calcula utilizando la distancia recta entre los extremos de las partes inconexas.	Boolean
Incluir todas las entidades en la clase de entidad de salida (Opcional)	Especifica si las entidades de ruta que no tienen ningún punto de calibración se incluirán en la clase de entidad de salida. Activado: todas las entidades de ruta se incluirán en la clase de entidad de salida. Esta es la opción predeterminada. Desactivado: no todas las entidades de ruta se incluirán necesariamente en la clase de entidad de salida. Se excluirán las entidades que no tienen puntos de calibración.	Boolean
Crear índice (Opcional)	Especifica si se creará un índice de atributos para el campo identificador de rutas que se escriba en el valor del parámetro Clase de entidad de ruta de salida. Activado: se creará un índice de atributo. Esta es la opción predeterminada. Desactivado: no se creará ningún índice de atributo.	Boolean

arcpy.lr.CalibrateRoutes(in_route_features, route_id_field, in_point_features, point_id_field, measure_field, out_feature_class, {calibrate_method}, {search_radius}, {interpolate_between}, {extrapolate_before}, {extrapolate_after}, {ignore_gaps}, {keep_all_routes}, {build_index})

Nombre	Explicación	Tipo de datos
in_route_features	Las entidades de ruta que se calibrarán.	Feature Layer
route_id_field	El campo que contiene los valores que identifican de manera única cada ruta. El campo puede ser un campo numérico, de texto o GUID.	Field
in_point_features	Las entidades de punto que se utilizarán para calibrar las rutas.	Feature Layer
point_id_field	El campo que identifica la ruta en la que se ubica cada punto de calibración. Los valores de este campo coinciden con aquellos del campo de identificador de rutas. Este campo puede ser un campo numérico, de texto o GUID.	Field
measure_field	El campo que contiene el valor de medición para cada punto de calibración. Este campo debe ser numérico.	Field
out_feature_class	La clase de entidad que se va a crear. Puede ser una clase de entidad de shapefile o de geodatabase.	Feature Class
calibrate_method (Opcional)	Especifica cómo se volverán a calcular las mediciones de ruta. DISTANCE—Las mediciones se volverán a calcular mediante la distancia de ruta más corta entre los puntos de calibración. Esta es la opción predeterminada. MEASURES—Las mediciones se volverán a calcular mediante la distancia de medida preexistente entre los puntos de calibración.	String
search_radius (Opcional)	Limita la distancia a la que puede estar un punto de calibración de una ruta al especificar la distancia y su unidad de medida. Si se desconoce la unidad de medida, se usarán las unidades del sistema de coordenadas de la clase de entidad de ruta.	Linear Unit
interpolate_between (Opcional)	Especifica si los valores de medición se interpolarán entre los puntos de calibración. BETWEEN—Los valores de medición se interpolarán entre los puntos de calibración. Esta es la opción predeterminada. NO_BETWEEN—Los valores de medición no se interpolarán entre los puntos de calibración.	Boolean
extrapolate_before (Opcional)	Especifica si los valores de medición se extrapolarán antes de los puntos de calibración. BEFORE—Los valores de medición se extrapolarán antes de los puntos de calibración. Esta es la opción predeterminada. NO_BEFORE—Los valores de medición no se extrapolarán antes de los puntos de calibración.	Boolean
extrapolate_after (Opcional)	Especifica si los valores de medición se extrapolarán después de los puntos de calibración. AFTER—Los valores de medición se extrapolarán después los puntos de calibración. Esta es la opción predeterminada. NO_AFTER—Los valores de medición no se extrapolarán después de los puntos de calibración.	Boolean
ignore_gaps (Opcional)	Especifica si se ignorarán los espacios cuando se vuelvan a calcular las medidas de las rutas inconexas. IGNORE—Se ignoran los espacios. Los valores de medición serán continuos para las rutas inconexas. Esta es la opción predeterminada. NO_IGNORE—No se ignoran los espacios. Los valores de medición de las rutas inconexas tendrán espacios. La distancia del espacio se calcula utilizando la distancia recta entre los extremos de las partes inconexas.	Boolean
keep_all_routes (Opcional)	Especifica si las entidades de ruta que no tienen puntos de calibración se incluirán en la clase de entidad de salida. KEEP—Todas las entidades de ruta se incluirán en la clase de entidad de salida. Esta es la opción predeterminada. NO_KEEP—No todas las entidades de ruta se incluirán necesariamente en la clase de entidad de salida. Se excluirán las entidades que no tienen puntos de calibración.	Boolean
build_index (Opcional)	Especifica si se creará un índice de atributos para el campo identificador de rutas escrito en el valor del parámetro out_feature_class. INDEX—Se creará un índice de atributo. Esta es la opción predeterminada. NO_INDEX—No se creará ningún índice de atributo.	Boolean

Muestra de código

Ejemplo 1 de CalibrateRoutes (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función CalibrateRoutes de modo inmediato.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.lr.CalibrateRoutes("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE", 
                         "C:/output/hwy_new.shp","DISTANCE", "5.0 feet", 
                         "BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")

Ejemplo 2 de CalibrateRoutes (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función CalibrateRoutes con datos de geodatabase de archivos en un script independiente de Python.

# Name CalibrateRoutes_Example2.py
# Description: Calibrate personal geodatabase routes with file geodatabase 
# points.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/Data/Pitt.gdb"

# Set local variables
rts = "roads/hwy"  # hwy is in the roads feature dataset
rid = "ROUTE1" 
pts = "roads/cal_pts"  # cal_pts is in the roads feature dataset
mfield = "MEASURE"
radius = "2.5 Meters"
out_fc = "roads/hwy_new"  # new feature class in the roads feature dataset

# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "BETWEEN", "NO_BEFORE", "NO_AFTER")

Ejemplo 3 de CalibrateRoutes (script independiente)

En el siguiente script de Python se muestra cómo utilizar la función CalibrateRoutes con datos de geodatabase corporativa en un script independiente de Python.

# Name CalibrateRoutes_Example3.py
# Description: Calibrate enterprise geodatabase routes using enterprise 
# geodatabase points.

# Import system modules
import arcpy

# Set workspace
wkspc = "C:/MyProject/myConn.sde"
arcpy.env.workspace = wkspc 

# Set local variables
rts = arcpy.ValidateTableName("hwy", wkspc)  # standalone feature class
rid = "ROUTE1"
pts = arcpy.ValidateTableName("cal_pts", wkspc)  # standalone feature class
mfield = "MEASURE"
radius = "5.0 Feet"
out_fc = "hwy_new" # new standalone feature class 

# Run CalibrateRoutes
arcpy.lr.CalibrateRoutes(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius, 
                         "#", "#", "#", "#", "NO_KEEP")

Entornos

Espacio de trabajo actual, Resolución M, Tolerancia M, Palabra clave CONFIG de salida, Palabra clave CONFIG de salida, Dominio XY de salida, Dominio Z de salida, Sistema de coordenadas de salida, Extensión, La salida tiene valores Z, Espacio de trabajo temporal

Información de licenciamiento

Basic: Sí
Standard: Sí
Advanced: Sí

Temas relacionados

¿Algún comentario sobre este tema?