De puntos a segmentos de rastreo (Herramientas AllSource)

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 tiempo 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 ingeniería de datos o la herramienta Calcular campo para convertir valores nulos en valores válidos antes de utilizar esta herramienta.

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 de velocidad de salida (`speed_mps`, `speed_mph`, `speed_kph` y `speed_knt`) en el valor del parámetro Clase de entidad de salida. Activado—Los campos de velocidad de salida se incluirán en la salida. Esta es la opción predeterminada. Desactivado—Los campos de velocidad de salida no se incluirán en la 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. Activado—Las marcas de tiempo duplicadas harán que la herramienta falle. Esta es la opción predeterminada. Desactivado—Se aceptarán las marcas de tiempo duplicadas. La secuencia de las marcas de tiempo duplicadas se basa en el valor `ObjectID`.	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. Activado—Los campos se transferirán del valor del parámetro Entidades de entrada al valor del parámetro Puntos de secuencia de salida. Desactivado—Los campos no se transferirán del valor del parámetro Entidades de entrada al valor del parámetro Puntos de secuencia de salida. Esta es la opción predeterminada.	Boolean

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`. `INCLUDE_VELOCITY`—Los campos de velocidad de salida se incluirán en la salida. Esta es la opción predeterminada. `EXCLUDE_VELOCITY`—Los campos de velocidad de salida no se incluirán en la salida.	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. `ERROR_DUPLICATE_TIMESTAMPS`—Las marcas de tiempo duplicadas harán que la herramienta falle. Esta es la opción predeterminada. `ALLOW_DUPLICATE_TIMESTAMPS`—Se aceptarán las marcas de tiempo duplicadas. La secuencia de las marcas de tiempo duplicadas se basa en el valor `ObjectID`.	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`. `KEEP_INPUT_FIELDS`—Los campos se transferirán del valor del parámetro `in_features` al valor del parámetro `out_point_feature_class`. `DISCARD_INPUT_FIELDS`—Los campos no se transferirán del valor del parámetro `in_features` al valor del parámetro `out_point_feature_class`. Esta es la opción predeterminada.	Boolean

Muestra de código

Ejemplo 1 de PointsToTrackSegments (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función PointsToTrackSegments en 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")

Ejemplo 2 de PointsToTrackSegments (script independiente)

El siguiente script de Python muestra cómo utilizar la función PointsToTrackSegments en un script 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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Basic: Sí
Standard: Sí
Avanzado: Sí

De puntos a segmentos de rastreo (Herramientas AllSource)

Resumen

Uso

Parámetros

Entornos

Información de licenciamiento

Temas relacionados