Buscar ubicaciones frecuentadas (AllSource)

Resumen

Identifica las áreas en las que un recorrido de movimientos ha permanecido durante varios periodos de tiempo y agrega esas ubicaciones en función de un identificador de rastreo.

Uso

  • La herramienta identifica ubicaciones en las que un recorrido de movimientos ha permanecido de forma constante. Esto ayuda a desarrollar un patrón normal de vida para un identificador único del recorrido de movimientos y la identificación de posibles áreas de interés nuevas para ayudar en las investigaciones.

    El patrón de vida es un conjunto específico de comportamientos y movimientos asociados con una entidad durante un periodo de tiempo determinado. Se utiliza ampliamente en investigaciones para comprender mejor cuándo se encontraba una entidad específica en una ubicación determinada en un momento o momentos específicos.

  • La siguiente terminología se utiliza en la herramienta Buscar ubicaciones frecuentadas:

    • Ubicación frecuentada: ubicación que representa los lugares en los que varias ubicaciones de permanencia se han intersecado en el espacio a lo largo de varios intervalos de tiempo.
    • Ubicación de permanencia: entidades que representan en qué momento un recorrido ha permanecido estacionario dentro de los parámetros de tiempo y distancia especificados.
    • Recorrido: una secuencia de entidades que tenga la función de tiempo habilitada con el instante de tipo tiempo. Las entidades están definidas para estar en la secuencia por un campo de identificación de recorrido y están ordenadas por el tiempo. Por ejemplo, las embarcaciones con una Identidad de Servicio Móvil Marítimo (MMSI, por sus siglas en inglés) informan de su ubicación en tiempo casi real. En este ejemplo, la MMSI puede representar los distintos recorridos.
    • Instante: un único momento en el tiempo representado por una hora de inicio y sin hora de finalización. Esto a veces se denomina instante de tiempo.
    • Intervalo: una duración de tiempo representada por una hora de inicio y una hora de finalización. Esto a veces se denomina intervalo de tiempo.

  • La herramienta Buscar ubicaciones frecuentadas se diferencia de la herramienta Buscar ubicaciones de reuniones en que Buscar ubicaciones de reuniones identifica las áreas en las que se colocan varios recorridos de movimiento únicos en el espacio y en el tiempo. La herramienta Buscar ubicaciones frecuentadas identifica las ubicaciones en las que un solo recorrido de movimiento permanece en la misma ubicación a través de varios intervalos de tiempo únicos.

  • Las ubicaciones de permanencia se determinan mediante los valores de los parámetros Tiempo mínimo de merodeo y Distancia de búsqueda. Primero, la herramienta asigna las entidades a un rastreo mediante un identificador único. El orden de los recorridos viene determinado por el tiempo de las entidades. A continuación, se calcula la distancia entre la primera observación de un rastreo y la siguiente. Se considera que las entidades pertenecen a una permanencia si dos puntos consecutivos en el tiempo permanecen dentro de una distancia determinada durante al menos una duración determinada. Si se encuentran dos entidades que forman parte de una permanencia, la primera entidad de la permanencia se utiliza como punto de referencia y la herramienta busca las entidades consecutivas que estén a un máximo de la distancia especificada respecto del punto de referencia de la permanencia. Una vez encontradas todas las entidades existentes dentro de la distancia especificada, la herramienta recopila las entidades de permanencia y calcula su centro medio. Las entidades anteriores y posteriores a la permanencia actual se agregan a la permanencia si están dentro de una distancia determinada respecto del centro medio de la ubicación de permanencia. Este proceso continúa hasta el final del rastreo.

    Las ubicaciones frecuentadas se determinan identificando primero todas las ubicaciones de permanencia presentes en el dataset. Una vez identificadas, las ubicaciones de permanencia que comparten el mismo identificador de rastreo se agrupan y fusionan. Si se especifica el valor de Permanencias mínimas por ubicación, la ubicación debe cumplir el valor de permanencias mínimas especificado para poder reunir los requisitos. Se calcularán estadísticas adicionales para determinar la primera y última vez que se visitó la ubicación, la cantidad total de permanencias individuales en la ubicación, la duración total de la ubicación y un desglose detallado de la actividad por día de la semana.

  • De forma predeterminada, el parámetro Límite de tiempo segmentará los datos del recorrido al comienzo de cada día a las 12:00 a.m. Si una ubicación de permanencia comienza el lunes 1 de enero a las 10:00 p.m. y termina el 2 de enero a las 2:00 a.m., se crearán ubicaciones de permanencia para la ubicación el 1 y el 2 de enero.

    Si, para los mismos datos, el valor de Límite de tiempo se define como 1 semana, se creará una única ubicación de permanencia con el valor 1 en el campo monday.

  • El tiempo debe estar habilitado en el valor del parámetro Entidades de entrada.

    Más información sobre cómo configurar las propiedades de tiempo en datos

  • El valor del parámetro Clase de entidad de salida contendrá los siguientes campos:

    • track_id: el identificador de rastreo único derivado del valor especificado en el parámetro Campo de Id. de recorrido
    • area_id: un valor único que representa a cada ubicación frecuentada identificada
    • total_dwells: el número de ubicaciones de permanencia identificadas para el recorrido especificado area_id
    • total_time: la suma de la duración en segundos de cada ubicación de permanencia individual
    • location_start: el primer instante de tiempo observado de la ubicación frecuentada
    • location_end: el último instante de tiempo observado de la ubicación frecuentada
    • sunday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un domingo
    • monday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un lunes
    • tuesday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un martes
    • wednesday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un miércoles
    • thursday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un jueves
    • friday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un viernes
    • saturday: la cantidad de ubicaciones de permanencia individuales que se han producido en el area_id especificado un sábado

  • Si el parámetro Normalizar distribución diaria está activado, los valores de los campos sunday, monday, tuesday, wednesday, thursday, friday, y saturday representarán el porcentaje del tiempo total pasado en esa ubicación en el día de la semana en concreto. Los valores estarán entre 0 y 1, donde el valor 1 representará el 100 por ciento. Si el parámetro Normalizar distribución diaria no está activado, el valor representará el valor real del tiempo pasado en la ubicación particular en ese día de la semana.

  • Esta herramienta de geoprocesamiento se basa en Spark. El análisis se completa en su equipo de escritorio utilizando varios núcleos en paralelo. Para un rendimiento óptimo, los datos deben estar disponibles en su equipo de sobremesa. Si los datos no están almacenados localmente, se tardará más tiempo en ejecutar esta herramienta.

Parámetros

EtiquetaExplicaciónTipo de datos
Entidades de entrada

Los puntos de rastreo de movimiento de entrada que se analizarán para detectar posibles ubicaciones frecuentadas. La capa debe tener el tiempo habilitado.

Feature Layer
Campo de Id. de recorrido

El campo que contiene los identificadores únicos que organizarán los datos de origen en recorridos de movimiento.

Field
Clase de entidad de salida

La clase de entidad poligonal de salida que contiene las posibles ubicaciones frecuentadas.

Feature Class
Expresión
(Opcional)

Una expresión de SQL utilizada para seleccionar un subconjunto de registros.

SQL Expression
Distancia de búsqueda
(Opcional)

La distancia de búsqueda máxima que un punto de recorrido de movimiento puede merodear antes de que deje de considerarse parte de una ubicación frecuentada. El valor predeterminado es 100 metros.

Linear Unit
Tiempo mínimo de merodeo
(Opcional)

La cantidad mínima de tiempo que un punto de rastreo de movimiento puede merodear por un área antes de que se considere que está permaneciendo en ella.

Este valor ayuda a identificar posibles ubicaciones frecuentadas en las que varios rastreos de movimiento únicos están permaneciendo en el mismo tiempo y espacio. El valor predeterminado es 10 minutos.

Time Unit
Límite de tiempo
(Opcional)

El intervalo de tiempo que se utilizará para dividir el valor del parámetro Entidades de entrada. Por ejemplo, si utiliza un límite de tiempo de 1 día, los recorridos se dividirán al comienzo de cada día.

Time Unit
Permanencias mínimas por ubicación
(Opcional)

El número mínimo de permanencias individuales superpuestas que se deben producir para que se definan como ubicación frecuentada. De forma predeterminada, se devolverán todas las ubicaciones que cumplan los criterios de una permanencia.

Long
Normalizar distribución diaria
(Opcional)

Especifica si se normalizará la distribución diaria de las ubicaciones de permanencia. Los valores normalizados representan un porcentaje del tiempo total en el que se produjo una ubicación de permanencia en un día determinado, mientras que los valores reales representan el número total de permanencias que se produjeron en el día determinado.

  • Activado: se normalizará la distribución diaria de los valores de las ubicaciones de permanencia.
  • Desactivado: no se normalizará la distribución diaria de los valores de las ubicaciones de permanencia. Esta es la opción predeterminada.

Boolean
Campos de resumen
(Opcional)

Especifica las estadísticas que se calcularán.

Es posible calcular estadísticas para las siguientes variables:

  • Hora de inicio: el tiempo en horas en que se detectó por primera vez la ubicación de permanencia individual. La hora se redondea a la hora más cercana.
  • Hora de fin: el tiempo en horas en que se detectó por última vez la ubicación de permanencia individual. La hora se redondea a la hora más cercana.
  • Duración de permanencia: el tiempo en segundos durante los que la ubicación de permanencia individual estuvo activa.

Se admiten las siguientes estadísticas:

  • Valor medio: el valor medio de los valores numéricos.
  • Mín: el valor mínimo de un campo numérico.
  • Máx: el valor máximo de un campo numérico.
  • Desviación estándar: la desviación estándar de un campo numérico.

Value Table

arcpy.intelligence.FindFrequentedLocations(in_features, track_id_field, out_featureclass, {expression}, {search_distance}, {minimum_loiter_time}, {time_boundary}, {minimum_dwells}, {normalize_daily_distribution}, {summary_fields})
NombreExplicaciónTipo de datos
in_features

Los puntos de rastreo de movimiento de entrada que se analizarán para detectar posibles ubicaciones frecuentadas. La capa debe tener el tiempo habilitado.

Feature Layer
track_id_field

El campo que contiene los identificadores únicos que organizarán los datos de origen en recorridos de movimiento.

Field
out_featureclass

La clase de entidad poligonal de salida que contiene las posibles ubicaciones frecuentadas.

Feature Class
expression
(Opcional)

Una expresión SQL utilizada para seleccionar un subconjunto de registros. Para obtener más información sobre la sintaxis SQL, consulte Referencia SQL para las expresiones de consulta utilizadas en ArcGIS.

SQL Expression
search_distance
(Opcional)

La distancia de búsqueda máxima que un punto de recorrido de movimiento puede merodear antes de que deje de considerarse parte de una ubicación frecuentada. El valor predeterminado es 100 metros.

Linear Unit
minimum_loiter_time
(Opcional)

La cantidad mínima de tiempo que un punto de rastreo de movimiento puede merodear por un área antes de que se considere que está permaneciendo en ella.

Este valor ayuda a identificar posibles ubicaciones frecuentadas en las que varios rastreos de movimiento únicos están permaneciendo en el mismo tiempo y espacio. El valor predeterminado es 10 minutos.

Time Unit
time_boundary
(Opcional)

El intervalo de tiempo que se utilizará para dividir el valor del parámetro Entidades de entrada. Por ejemplo, si utiliza un límite de tiempo de 1 día, los recorridos se dividirán al comienzo de cada día.

Time Unit
minimum_dwells
(Opcional)

El número mínimo de permanencias individuales superpuestas que se deben producir para que se definan como ubicación frecuentada. De forma predeterminada, se devolverán todas las ubicaciones que cumplan los criterios de una permanencia.

Long
normalize_daily_distribution
(Opcional)

Especifica si se normalizará la distribución diaria de las ubicaciones de permanencia. Los valores normalizados representan un porcentaje del tiempo total en el que se produjo una ubicación de permanencia en un día determinado, mientras que los valores reales representan el número total de permanencias que se produjeron en el día determinado.

  • NORMALIZEDSe normalizará la distribución diaria de los valores de las ubicaciones de permanencia.
  • REALNo se normalizará la distribución diaria de los valores de las ubicaciones de permanencia y se representará el valor real. Esta es la opción predeterminada.
Boolean
summary_fields
[summary_fields,...]
(Opcional)

Especifica las estadísticas que se calcularán.

Es posible calcular estadísticas para las siguientes variables:

  • START_TIME: el tiempo en horas en que se detectó por primera vez la ubicación de permanencia individual. La hora se redondea a la hora más cercana.
  • END_TIME: el tiempo en horas en que se detectó por última vez la ubicación de permanencia individual. La hora se redondea a la hora más cercana.
  • DWELL_DURATION: El tiempo en segundos durante los que la ubicación de permanencia individual estuvo activa.

Se admiten las siguientes estadísticas:

  • MEAN: el valor medio de los valores numéricos.
  • MIN: el valor mínimo de un campo numérico.
  • MAX: el valor máximo de un campo numérico.
  • STDDEV: la desviación estándar de un campo numérico.

Value Table

Muestra de código

Ejemplo de FindFrequentedLocations (script independiente)

El siguiente script de Python demuestra cómo utilizar la función FindFrequentedLocations en un script independiente.

# Name FindFrequentedLocations.py
# Description: Find frequented locations in a track dataset.

import arcpy

arcpy.env.workspace = "C:/data/Tracks.gdb"

fc = "Movement_Tracks"
track_field = "user"
out_fc = "frequented_locations"
where_statement = "user = 'user_1'"
distance = "100 Meters"
loiter_time = "10 Minutes"
boundary = "1 Days"
min_dwells = 5
daily_dist = "NORMALIZED"

arcpy.intelligence.FindFrequentedLocations(fc, 
                                           track_field, 
                                           out_fc, 
                                           where, 
                                           distance, 
                                           loiter_time, 
                                           boundary, 
                                           min_dwells, 
                                           daily_dist)