Etiqueta | Explicación | Tipo 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.
| Boolean |
Campos de resumen (Opcional) | Especifica las estadísticas que se calcularán. Es posible calcular estadísticas para las siguientes variables:
Se admiten las siguientes estadísticas:
| Value Table |
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
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})
Nombre | Explicación | Tipo 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.
| Boolean |
summary_fields [summary_fields,...] (Opcional) | Especifica las estadísticas que se calcularán. Es posible calcular estadísticas para las siguientes variables:
Se admiten las siguientes estadísticas:
| Value Table |
Muestra de código
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)
Entornos
Casos especiales
Información de licenciamiento
- Basic: No
- Standard: No
- Advanced: Sí