De puntos a segmentos de rastreo (Inteligencia)

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 campoAlias del campoDescripción
    d_startStart Date

    Fecha y hora de inicio

    d_start_sStart Date (string)

    Fecha y hora de inicio como cadena de caracteres o texto

    d_endEnd Date

    Fecha y hora de fin

    d_end_sEnd Date (string)

    Fecha y hora de fin como cadena de caracteres o texto

    distance_mDistance (meters)

    Distancia en metros

    dt_secTime Delta (seconds)

    Diferencia horaria en segundos

    dt_minTime Delta (minutes)

    Diferencia horaria en minutos

    speed_mpsSpeed (meters per second)

    Opcional. Velocidad en metros por segundo

    speed_mphSpeed (miles per hour)

    Opcional. Velocidad en millas por hora

    speed_kphSpeed (kilometers per hour)

    Opcional. Velocidad en kilómetros por hora

    speed_kntSpeed (knots)

    Opcional. Velocidad en nudos

    oid_startStart ObjectID

    Id. de objeto del punto inicial de Entidades de entrada

    oid_endEnd ObjectID

    Id. de objeto del punto final de Entidades de entrada

    group_idGroup 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 campoAlias del campoDescripción
    sequenceSequence Number

    Número de secuencia del punto en el rastreo

    dateDate

    Campo datetime del parámetro Entidades de entrada

    date_strDate (string)

    Campo datetime como cadena de caracteres

    oid_origOriginal ObjectID

    Id. de objeto de la entidad original del parámetro Entidades de entrada

    group_idGroup 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

EtiquetaExplicaciónTipo 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.

  • 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})
NombreExplicaciónTipo 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_VELOCITYLos campos de velocidad de salida se incluirán en la salida. Esta es la opción predeterminada.
  • EXCLUDE_VELOCITYLos 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_TIMESTAMPSLas marcas de tiempo duplicadas harán que la herramienta falle. Esta es la opción predeterminada.
  • ALLOW_DUPLICATE_TIMESTAMPSSe 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_FIELDSLos campos se transferirán del valor del parámetro in_features al valor del parámetro out_point_feature_class.
  • DISCARD_INPUT_FIELDSLos 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)

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")
Ejemplo 2 de PointsToTrackSegments (script independiente)

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)

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.