Etiqueta | Explicación | Tipo de datos |
Entidades de entrada | Las entidades de puntos como posiciones de puntos a lo largo de rastreos que se van a crear. | Feature Layer |
Campo de fecha | El campo de fecha que se utilizará para ordenar los puntos de Entidades de entrada. | Field |
Clase de entidad de salida | Las entidades de línea de rastreo de salida. | Feature Class |
Campo de grupo (Opcional) | Un campo del parámetro Entidades de entrada que se utilizará para agrupar los puntos de entrada. Cada grupo único creará un rastreo separado. | Field |
Incluir campos de velocidad (Opcional) | Especifica si se incluirán los campos de velocidad (speed_mps, speed_mph, speed_kph y speed_knt) en el valor del parámetro Clase de entidad de salida.
| Boolean |
Puntos de secuencia de salida (Opcional) | Las entidades de punto de salida. La salida incluirá un campo SEQUENCE que contiene el orden que se utilizará para la ruta creada en el parámetro Clase de entidad de salida. | Feature Class |
Error en marcas de tiempo duplicadas (Opcional) | Especifica si las marcas de tiempo duplicadas en el valor del parámetro Campo de fecha o en cada grupo del valor del parámetro Campo de grupo se aceptarán o harán que la herramienta falle.
| Boolean |
Mantener campos de entrada (Opcional) | Especifica si los campos se transferirán del valor del parámetro Entidades de entrada al valor del parámetro Puntos de secuencia de salida.
| Boolean |
Resumen
Convierte secuencias de datos de puntos de entrada con la función de tiempo habilitada (como puntos GPS) a una serie de rutas de salida.
Uso
Si los valores del parámetro Entidades de entrada se encuentran en un sistema de coordenadas proyectadas, el valor del parámetro Clase de entidad de salida utilizará el mismo sistema de coordenadas. Si los valores del parámetro Entidades de entrada se encuentran en un sistema de coordenadas geográficas, el valor del parámetro Clase de entidad de salida utilizará Acimutal equidistante mundial.
Si los valores del parámetro Entidades de entrada tienen puntos con las mismas coordenadas, se agrega un desplazamiento de 1 centímetro a la segunda coordenada y cuando se crea cada línea de salida. Se debe a que el modelo de geometría no permite vértices duplicados en una única polilínea.
Si los puntos de Entidades de entrada están en Web Mercator proyectado, puede haber discrepancias entre los valores de los campos Shape Length y distance_m porque los valores del campo distance_m se calculan con una longitud geodésica y se consideran más precisos.
Se agregarán los siguientes campos al valor del parámetro Clase de entidad de salida:
Nombre de campo Alias del campo Descripción d_start Start Date Fecha y hora de inicio
d_start_s Start Date (string) Fecha y hora de inicio como cadena de caracteres o texto
d_end End Date Fecha y hora de fin
d_end_s End Date (string) Fecha y hora de fin como cadena de caracteres o texto
distance_m Distance (meters) Distancia en metros
dt_sec Time Delta (seconds) Diferencia horaria en segundos
dt_min Time Delta (minutes) Diferencia horaria en minutos
speed_mps Speed (meters per second) Opcional. Velocidad en metros por segundo
speed_mph Speed (miles per hour) Opcional. Velocidad en millas por hora
speed_kph Speed (kilometers per hour) Opcional. Velocidad en kilómetros por hora
speed_knt Speed (knots) Opcional. Velocidad en nudos
oid_start Start ObjectID Id. de objeto del punto inicial de Entidades de entrada
oid_end End ObjectID Id. de objeto del punto final de Entidades de entrada
group_id Group Identification Opcional. Valores de Campo de grupo del parámetro Entidades de entrada
Se agregarán los siguientes campos al valor del parámetro Puntos de secuencia de salida:
Nombre de campo Alias del campo Descripción sequence Sequence Number Número de secuencia del punto en el rastreo
date Date Campo datetime del parámetro Entidades de entrada
date_str Date (string) Campo datetime como cadena de caracteres
oid_orig Original ObjectID Id. de objeto de la entidad original del parámetro Entidades de entrada
group_id Group Identification Opcional. Valores de Campo de grupo del parámetro Entidades de entrada
Se creará un archivo .lyrx de salida (configuración de capa y simbología) para los parámetros Clase de entidad de salida y Puntos de secuencia de salida. Estos archivos se crearán en el espacio de trabajo de carpeta más cercano que contiene las entidades de salida.
Si el parámetro Incluir velocidad está activado y el parámetro Error en marcas de hora duplicadas no lo está, las marcas de hora duplicadas que mida la velocidad de rastreo de salida serán "inf", donde "inf" significa "infinito", independientemente de la distancia entre los puntos.
Los valores nulos del valor del parámetro Campo de grupo no se procesarán. Los valores nulos no se pueden ordenar ni agrupar como parte del procesamiento de puntos de entrada, así que se omitirán estas filas. Para evitar este problema, utilice la ingeniería de datos o la herramienta Calcular campo para convertir valores nulos en valores válidos antes de utilizar esta herramienta.
Parámetros
arcpy.intelligence.PointsToTrackSegments(in_features, date_field, out_feature_class, {group_field}, {include_velocity}, {out_point_feature_class}, {error_on_duplicate_timestamps}, {keep_input_fields})
Nombre | Explicación | Tipo de datos |
in_features | Las entidades de puntos como posiciones de puntos a lo largo de rastreos que se van a crear. | Feature Layer |
date_field | El campo de fecha que se utilizará para ordenar los puntos de in_features. | Field |
out_feature_class | Las entidades de línea de rastreo de salida. | Feature Class |
group_field (Opcional) | Un campo del parámetro in_features que se utilizará para agrupar los puntos de entrada. Cada grupo único creará un rastreo separado. | Field |
include_velocity (Opcional) | Especifica si se incluirán los campos de velocidad de salida (speed_mps, speed_mph, speed_kph y speed_knt) en el valor del parámetro out_feature_class.
| Boolean |
out_point_feature_class (Opcional) | Las entidades de punto de salida. La salida incluirá un campo SEQUENCE que contiene el orden que se utilizará para la ruta creada en el parámetro out_feature_class. | Feature Class |
error_on_duplicate_timestamps (Opcional) | Especifica si las marcas de tiempo duplicadas en el valor del parámetro date_field o en cada grupo del valor del parámetro group_field se aceptarán o harán que la herramienta falle.
| Boolean |
keep_input_fields (Opcional) | Especifica si los campos se transferirán del valor del parámetro in_features al valor del parámetro out_point_feature_class.
| Boolean |
Muestra de código
La siguiente secuencia de comandos de la ventana de Python muestra cómo utilizar la función PointsToTrackSegments de modo inmediato:
import arcpy
arcpy.intelligence.PointsToTrackSegments("C:/data/mtracks.gdb/source_pts",
"DateTime",
"C:/data/mtracks.gdb/tracklines",
"Name",
"INCLUDE_VELOCITY",
"C:/data/mtracks.gdb/seqpoints")
La siguiente secuencia de comandos de Python muestra cómo utilizar la función PointsToTrackSegments en una secuencia de comandos independiente:
# Name: PointsToTrackSegments_Example2.py
# Description: Convert points to track segments.
# Import system modules
import arcpy
# Set local variables
in_features = "C:/data/mtracks.gdb/source_pts"
date_time = "DateTime"
out_feature_class = "C:/data/mtracks.gdb/tracklines"
group_field = "Name"
out_points = "C:/data/mtracks.gdb/seqpoints"
# Run PointsToTrackSegments
arcpy.intelligence.PointsToTrackSegments(in_features, date_time,
out_feature_class, group_field,
"INCLUDE_VELOCITY", out_points)