Resumen
Identifica eventos de giro, eventos de aceleración y la velocidad de un dataset de rastreo de puntos de entrada.
Uso
Para que la herramienta se ejecute, el valor del parámetro Entidades de entrada debe estar en un sistema de coordenadas proyectadas y debe tener habilitada la función de tiempo.
La herramienta identificará los siguientes eventos:
- Giro a la derecha o a la izquierda
- Cambio de sentido a la derecha o a la izquierda
- Aceleración
- Deceleración
- Arranque
- Parada
- Velocidad en millas por hora
- Velocidad en kilómetros por hora
- Diferencia de distancia entre el punto actual y el punto anterior del recorrido
- Diferencia de tiempo entre el punto actual y el punto anterior del recorrido
- Nombre de la región de interés donde se encuentra el punto actual si se proporciona la clase de entidad Regiones de interés
Los giros se calculan con los parámetros Curvatura y Número de puntos. Cada punto se evalúa como una serie de triángulos calculados utilizando el punto actual y los puntos delante y detrás del punto actual en el valor de parámetro Número de puntos especificado. A continuación, se calcula la curva de Menger, lo que permite detectar los giros.
Los valores predeterminados de los parámetros Curvatura y Número de puntos se optimizan para recorridos típicos de automóviles, suponiendo una tasa de muestreo aproximada de un segundo. Los vehículos que se mueven más rápido que los automóviles o los datos que se muestrean en un intervalo distinto de uno por segundo pueden requerir un cambio en los parámetros Curvatura o Número de puntos. Por ejemplo, una persona que utiliza un dispositivo GPS personal que muestrea una vez cada cinco segundos puede disminuir el valor de Número de puntos. Los datos que representan un avión que se muestrea una vez por segundo pueden ajustar el valor del parámetro Curvatura a 1,5 o inferior para tener en cuenta la mayor cantidad de tiempo y espacio que se requiere para que un avión realice un giro.
La velocidad se calcula utilizando la distancia entre puntos dividida por la cantidad de tiempo necesaria para recorrer esa distancia. Las paradas se identifican cuando un vehículo tiene una velocidad de cero. Los arranques se determinan a partir de cuando los puntos aceleran desde una posición de parada.
La clase de entidad de salida contendrá los siguientes campos:
- track_id: el identificador único que asocia el punto a un recorrido. Este campo se deriva del parámetro Campo de Id.
- time: el tiempo asociado a la entidad de rastreo de puntos. Este campo se deriva del campo de tiempo especificado en las propiedades de capa.
- POINT_X: la coordenada x asociada a la entidad actual.
- POINT_Y: la coordenada y asociada a la entidad actual.
- distance_diff: la distancia entre la entidad anterior del recorrido y la entidad actual. La distancia se calcula en las unidades del sistema de coordenadas de entrada.
- time_diff: la diferencia en segundos entre la entidad anterior del recorrido y la entidad actual.
- speed: la velocidad en las unidades lineales del sistema de coordenadas de entrada por segundo.
- speed_MPH: la velocidad en millas por hora del recorrido desde la entidad anterior del recorrido a la entidad actual.
- speed_KMPH: la velocidad en kilómetros por hora del recorrido desde la entidad anterior del recorrido a la entidad actual.
- acc_event: eventos de aceleración. Entre los eventos de aceleración específicos se incluyen los siguientes:
- Inicio de aceleración: el punto en el que empieza a acelerarse el recorrido.
- Inicio de frenada: el punto en el que empieza a ralentizarse el recorrido.
- Aceleración: el rastreo de puntos tiene una velocidad creciente entre el punto anterior y el punto actual. Esto debe ocurrir después de Inicio de aceleración.
- Frenada: el rastreo de puntos tiene una velocidad decreciente entre el punto anterior y el punto actual. Esto debe ocurrir después de Fin de frenada.
- Fin de aceleración: el punto en el que se detiene un evento de aceleración. Esto suele ir seguido de Desplazamiento o de un evento de frenada.
- Fin de frenada: el punto en el que se detiene un evento de frenada. Esto suele ir seguido de Detenido o de un evento de aceleración.
- Detenido: el rastreo de puntos no se mueve. La velocidad debe ser igual a 0 mph o 0 km/h.
- Desplazamiento: el rastreo de puntos se mueve a una velocidad que no pertenece a ninguna de las categorías anteriores.
- turn_event: un evento de giro. Entre los eventos de giro específicos se encuentran: giro a la izquierda, giro a la derecha, cambio de sentido a la izquierda, cambio de sentido a la derecha y desplazamiento.
Si el valor del parámetro opcional Regiones de interés tiene una clase de entidad asociada, se rellenará un campo roi_id. Este campo incluirá la región de interés que interseca el punto.
Sintaxis
arcpy.intelligence.ClassifyMovementEvents(in_features, id_field, out_featureclass, {curvature}, {number_of_points}, {regions_of_interest}, {roi_id_field})| Parámetro | Explicación | Tipo de datos |
in_features | Una capa de entidades de punto con la función de tiempo habilitada con un campo que anota el recorrido al que está asociado cada punto. La geometría, el identificador de objeto, el nombre del recorrido y el tiempo se transferirán a la clase de entidad de salida. La entrada debe estar en un sistema de coordenadas proyectadas. | Feature Layer |
id_field | Un campo de las entidades de entrada que se usará para obtener los identificadores únicos por rastreo de puntos. El campo se copiará a la clase de entidad de salida. | Field |
out_featureclass | La clase de entidad de salida que contendrá los eventos de movimiento calculados. | Feature Class |
curvature (Opcional) | El valor mínimo necesario para clasificar un evento como evento de giro. Una vez calculada la curvatura, cualquier curvatura calculada mayor que este valor hará que el campo turn_event se rellene con el evento de giro relevante, mientras que los valores menores que este harán que el campo turn_event se clasifique como Desplazamiento. Para determinar si un evento cumple con los criterios de un evento de giro, se calcula una curva de Menger basada en tres puntos. La distancia entre estos puntos se especifica en el parámetro Número de puntos. El valor predeterminado 2 del parámetro Curvatura es adecuado para automóviles y peatones. Para vehículos de mayor velocidad, como un avión, es posible que tenga que utilizar un valor menor o aumentar el valor del parámetro Número de puntos. | Double |
number_of_points (Opcional) | El número de puntos a evaluar antes y después de un punto determinado al calcular la curva de Menger. Al utilizar datos con una tasa de muestreo alta (subsegundo), es posible que tenga que aumentar el valor del parámetro Número de puntos para tener en cuenta la posible reducción de movimiento en ese breve periodo de tiempo. El valor predeterminado 5 es adecuado para automóviles y peatones, suponiendo un muestreo de un segundo en los datos de entrada. | Long |
regions_of_interest (Opcional) | Las regiones de interés. Esta capa de entidades de entrada opcional debe ser una clase de entidad poligonal. Si se proporciona, se agregará un campo roi al parámetro Clase de entidad de salida. | Feature Layer |
roi_id_field (Opcional) | Un campo del parámetro Regiones de interés que contiene los identificadores únicos de cada región de interés. | Field |
Muestra de código
El siguiente script independiente de Python muestra cómo utilizar la función ClassifyMovementEvents.
# Name: ClassifyMovementEvents.py
# Description: Identify movement events in a point track dataset.
# Import system modules
import arcpy
arcpy.env.workspace = "C:/data/Tracks.gdb"
# Set local variables
source_features = "Known_Tracks"
output_movement_events = "MovementEvents"
id_field = "device_id"
regions_of_interest = "Named_Areas_Of_Interest"
roi_name = "counties"
# Execute tool
arcpy.ClassifyMovementEvents_intelligence(source_features,
output_point_features,
id_field,
regions_of_interest,
roi_name)Entornos
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí