Resumen
Recalcula las mediciones de ruta mediante puntos.
Uso
Se pueden calibrar rutas en forma total o parcial. Puede elegir 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 tres métodos.
Use Crear capa de entidades o Crear tabla de consulta para reducir eficazmente las rutas que se calibrarán.
Si la Clase de entidad de rutas de salida se va a escribir en una geodatabase, debe establecer un entorno de Tolerancia M, Resolución M y Dominio M adecuado.
La Clase de entidad de ruta de salida que contiene todos los campos de las Entidades de ruta de entrada.
La variable de entorno outputMFlag se omite. La Clase de entidad de ruta de salida tendrá valores m (de medición).
No se puede especificar un radio de búsqueda de infinidad.
Un índice de atributos en el campo de identificador de rutas acelera el proceso de segmentación dinámica. Si va a utilizar la Clase de entidad de ruta de salida para la segmentación dinámica, se recomienda que elija crear un índice de atributos.
Si el proceso Calibrar rutas rechaza una o varias 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 de la Clase de entidad de ruta de salida).
Sintaxis
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})| Parámetro | Explicación | Tipo de datos |
in_route_features | Las entidades de ruta que se van a calibrar. | Feature Layer |
route_id_field | El campo que contiene los valores que identifican de manera única cada ruta. Este campo puede ser numérico o de carácter. | Field |
in_point_features | Las entidades de punto que se utilizaron 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 numérico o de carácter. | 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 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.
| 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.
| Boolean |
extrapolate_before (Opcional) | Especifica si los valores de medición 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.
| Boolean |
ignore_gaps (Opcional) | Especifica si se ignorarán los espacios cuando se vuelvan a calcular las medidas de las rutas inconexas.
| Boolean |
keep_all_routes (Opcional) | Especifica si las entidades de ruta que no tienen ningún punto de calibración se excluirán de la clase de entidad de salida.
| Boolean |
build_index (Opcional) | Especifica si se creará un índice de atributos para el campo identificador de rutas que se escriba en la out_feature_class.
| Boolean |
Muestra de código
El siguiente script de la ventana de Python demuestra cómo utilizar la función CalibrateRoutes en modo inmediato.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CalibrateRoutes_lr("hwy.shp", "RID", "cal_pts.shp", "RID", "MEASURE",
"C:/output/hwy_new.shp","DISTANCE", "5.0 feet",
"BETWEEN", "BEFORE", "AFTER", "#", "NO_KEEP")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
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
"BETWEEN", "NO_BEFORE", "NO_AFTER")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
# Execute CalibrateRoutes
arcpy.CalibrateRoutes_lr(rts, rid, pts, rid, mfield, out_fc, "DISTANCE", radius,
"#", "#", "#", "#", "NO_KEEP")Entornos
Información de licenciamiento
- Basic: Sí
- Standard: Sí
- Advanced: Sí