Resumen
Traza eventos cercanos entre sí en el espacio (ubicación) y el tiempo. Los datos de puntos con la función de tiempo habilitada deben incluir entidades que representen un instante en el tiempo.
Ilustración
Uso
A continuación se muestran ejemplos de casos de uso que se pueden realizar con la herramienta Trazar eventos de proximidad:
- Una organización monitoriza los dispositivos suministrados por la empresa que llevan los trabajadores. La empresa está interesada en determinar qué empleados estaban cerca de una persona que se sabe que padece la enfermedad por coronavirus de 2019 (COVID-19). Al utilizar la capa de puntos que representa las ubicaciones y la hora de los dispositivos, identifican los dispositivos que se encuentran a menos de seis metros y cinco minutos de la persona transmisora y de otros empleados posiblemente transmisores.
- Una ONG está monitorizando las poblaciones de salmón mediante GPS y está interesada en realizar un seguimiento de la propagación del piojo del salmón entre las poblaciones de salmón cultivado escapado y las poblaciones silvestres. Se realiza el seguimiento de algunos salmones cultivados marcados con GPS para ver si se encuentran muy cerca de las poblaciones silvestres marcadas y cómo estas poblaciones silvestres pueden propagar aún más la enfermedad. Las mediciones también incluyen un campo de profundidad, el cual la ONG utiliza para buscar solo los peces a una profundidad similar.
La siguiente terminología se utiliza en la herramienta Trazado de eventos de proximidad:
- Entidad: un objeto cuya posición se registra periódicamente; por ejemplo, un animal, una persona o un vehículo. Una entidad puede ser fija o móvil.
- Entidades de interés: las entidades específicas utilizadas para iniciar un trazado; por ejemplo, una persona con COVID-19.
- Evento de proximidad: el periodo de tiempo en el que dos entidades están cerca entre sí; por ejemplo, dos personas que están a menos de 3 metros entre sí y dentro de una ventana de 1 minutos entre sí.
- Profundidad: el grado de separación entre una entidad de interés y una entidad más abajo en el trazado (aguas abajo). Por ejemplo, un evento de proximidad entre la entidad de interés y otra persona es la profundidad 1.
- Evento de trazado: el primer contacto para una entidad especificada aguas abajo de las entidades de interés.
Los diagramas que aparecen a continuación muestran cómo la herramienta Trazado de eventos de proximidad trata los datos. En estos diagramas, el tiempo está en el eje x.
En cada diagrama, hay cuatro entidades: A, B, C y D. El texto resaltado describe los eventos de trazado que ocurren entre dos entidades (las entidades de origen y destino) y la profundidad del evento de proximidad. En este ejemplo, la entidad C es la entidad de interés que se está trazando aguas abajo.
En el diagrama 1, la entidad C es la entidad de interés elegida. La profundidad es 0.
En el diagrama 2, se produce un evento de proximidad entre las entidades C y B. La profundidad del trazado es 1. Cuando varias entidades son eventos de proximidad posteriores, se trata de un evento de proximidad sostenido.
En el diagrama 3, se produce un evento de proximidad entre las entidades B y A. La profundidad del trazado es 2.
En el diagrama 4, se produce un evento de proximidad entre las entidades C y D. La profundidad del trazado es 1.
En la siguiente imagen, la entidad B es la entidad de interés y está próxima a la entidad A tres veces, indicado por los círculos azules. Suponiendo que el tiempo está en el eje x, el primer evento de proximidad es 1, seguido de un descanso sin contacto y, a continuación, los eventos de proximidad 2 y 3. La herramienta devolverá el evento 1 como el evento de trazado. Los eventos de proximidad 2 y 3 no se devuelven en la capa del parámetro Eventos de proximidad de salida. Todas las entidades después del evento de proximidad 1 se devuelven en el parámetro Recorridos de salida.
Las entidades deben cumplir los criterios de los parámetros Distancia de búsqueda espacial y Distancia de búsqueda temporal para considerarse próximos entre sí.
Figura A: las dos entidades están dentro de una distancia de búsqueda espacial entre sí. 
Figura B: las dos entidades están dentro de una distancia de tiempo (distancia de búsqueda temporal) entre sí. Especificar una distancia de búsqueda temporal y una distancia de búsqueda espacial mayores dará como resultado más eventos y tardará más tiempo en procesar los resultados. Las distancias más pequeñas generarán menos eventos y el tiempo de procesamiento será más corto.
Utilice conocimientos específicos del ámbito para determinar los valores utilizados para los parámetros Distancia de búsqueda espacial y Distancia de búsqueda temporal. Tenga en cuenta factores como la precisión del dispositivo al establecer las distancias.
El parámetro Definir entidades de interés utilizando admite las siguientes opciones:
- Id. de entidades de interés: esta opción habilita el parámetro Id. de entidades de interés, el cual requiere valores para Id. de entidad y valores temporales opcionales para Empezar desde para empezar el trazado a partir de ese momento.
- Entidades seleccionadas en una capa de entidades de interés especificada: esta opción habilita el parámetro Capa de entidades de interés, que le permite elegir una capa que incluya los Id. de entidad y, opcionalmente, las horas a partir de las cuales empezará el trazado. Para esta capa, el nombre del campo Id. de entidad debe coincidir con el nombre del campo Id. de entidad de la capa de entrada. El tiempo se utilizará en esta capa si la capa tiene el tiempo habilitado.
La entidad de interés es donde comenzará el trazado de proximidad. Si especifica una hora para Empezar desde, el trazado empezará en ese momento para esa entidad. Si no especifica ninguna hora, el trazado empezará el 1 de enero de 1970 para esa entidad.
Puede establecer requisitos adicionales para un evento de proximidad. Por ejemplo, puede trazar solo personas de un edificio concreto en un campus o puede trazar solo aquellas dentro de un nivel de un edificio. Utilice el parámetro Criterios de coincidencia de atributos para especificar los atributos de restricción. Por ejemplo, para restringir entidades en la misma planta, especifique el campo Floor.
La capa Eventos de proximidad de salida contendrá el primer evento de proximidad para las entidades del trazado, así como los siguientes campos:
- from_id: el Id. de la entidad aguas arriba.
- to_id: el Id. de la entidad aguas abajo.
- depth: el grado de separación entre la entidad de interés y el campo to_id.
- duration_minutes: la duración del evento de trazado en minutos. Este campo se calcula como la diferencia entre las horas de inicio y finalización. Por ejemplo, 1,5 minutos son 90 segundos. Un valor de 0 significa que hay un único evento de proximidad (horas de inicio y finalización idénticas).
- instant_datetime: la fecha y hora del evento de proximidad. Este campo se calcula como la primera hora registrada que cumple los criterios del evento de proximidad.
La capa Eventos de proximidad de salida se puede visualizar con el control deslizante de tiempo o en un gráfico de vínculos para visualizar los resultados del trazado.
Puede utilizar el parámetro opcional Recorridos de salida para crear una capa que contenga el primer evento de trazado y todas las entidades posteriores para esa entidad. Estos resultados son útiles para visualizar por dónde se desplazaron las entidades y se pueden utilizar en la herramienta Reconstruir recorridos. El parámetro Recorridos de salida incluirá los siguientes campos:
- entity_id: el Id. de entidad.
- depth: el grado de separación entre la entidad de interés y el recorrido del trazado. La profundidad será la misma en un solo recorrido.
- date: la fecha de cada entidad. Esta será la misma fecha que el registro de las entidades de entrada.
Los puntos de entrada que no tienen valores de tiempo, valores de geometría o un campo de Id. de entidad no se incluyen en los resultados.
Al utilizar el trazado de proximidad para hallar la transmisión (por ejemplo, de una enfermedad), tenga en cuenta lo siguiente:
- La presencia de un evento de trazado no garantiza que se haya transmitido; solo es una posible ocurrencia.
- La ausencia de un evento de trazado no significa que no se haya transmitido algo. En casos como una enfermedad, puede haber transmisión a través de otros vectores.
- Cuando sea posible, utilice el parámetro Criterios de coincidencia de atributos para restringir los eventos de proximidad cuando sea necesario. Por ejemplo, utilice atributos para restringir la sala, la planta o la elevación.
Si le interesa calcular todos los eventos de proximidad, pero no le interesa trazar aguas abajo desde una entidad de interés, utilice la herramienta Unir entidades.
Puede mejorar el rendimiento de la herramienta Trazar eventos de proximidad realizando una o varias de las siguientes acciones:
- Utilice valores más pequeños para los parámetros Distancia de búsqueda espacial y Distancia de búsqueda temporal.
- Limite las entidades de interés utilizando el parámetro Criterios de coincidencia de atributos.
- Especifique un valor para Profundidad máxima de trazado para limitar el número de trazados aguas abajo de una entidad determinada y la entidad de interés.
- Defina el entorno de extensión para analizar únicamente datos de interés.
- Utilice datos locales en los que se ejecute el análisis.
Al ejecutar herramientas de GeoAnalytics Server, el análisis se completa en GeoAnalytics Server. Para obtener un rendimiento óptimo, haga que los datos estén disponibles para GeoAnalytics Server mediante capas de entidades alojadas en su portal de ArcGIS Enterprise o mediante recursos compartidos de archivos de big data. Los datos que no son locales para su GeoAnalytics Server se moverán a GeoAnalytics Server antes de que comience el análisis. Significa que ejecutar una herramienta tardará más tiempo y, en algunos casos, mover los datos de ArcGIS Pro a GeoAnalytics Server podría fallar. El umbral de error depende de la velocidad de su red, así como del tamaño y complejidad de los datos. Por lo tanto, se recomienda que siempre comparta sus datos o que cree un recurso compartido de archivos de big data.
Más información acerca del uso compartido de datos en el portal
Más información sobre cómo crear un archivo compartido de Big Data mediante Server Manager
Sintaxis
arcpy.geoanalytics.TraceProximityEvents(in_points, entity_id_field, output_name, distance_method, {spatial_search_distance}, {temporal_search_distance}, entities_of_interest_input_type, entities_interest_ids, entities_interest_layer, {include_tracks_layer}, max_trace_depth, {attribute_match_criteria}, {data_store})| Parámetro | Explicación | Tipo de datos |
in_points | La clase de entidad de puntos con la función de tiempo habilitada que se utilizará para trazar eventos de proximidad. | Feature Set |
entity_id_field | El campo que representa Id. únicos para cada entidad. | Field |
output_name | El nombre del servicio de entidades de salida. | String |
distance_method | Especifica el tipo de distancia que se utilizará con el parámetro Distancia de búsqueda espacial.
| String |
spatial_search_distance (Opcional) | La distancia máxima entre dos puntos para que se consideren en proximidad. Se considera que las entidades dentro de los criterios de distancia de búsqueda espacial y distancia de búsqueda temporal están próximas entre sí. | Linear Unit |
temporal_search_distance (Opcional) | La duración máxima entre dos puntos para que se consideren en proximidad. Se considera que las entidades dentro de la distancia de búsqueda temporal y que satisfacen los criterios de distancia de búsqueda espacial están próximas entre sí. | Time Unit |
entities_of_interest_input_type | Especifica las entidades de interés.
| String |
entities_interest_ids [entities_interest_ids,...] | Los nombres de entidad y las horas de inicio para las entidades de interés. Este parámetro solo se admite al especificar ID_START_TIME para el parámetro entities_of_interest_input_type.
| Value Table |
entities_interest_layer | Capa o tabla que contiene las entidades de interés. Este parámetro solo se admite al especificar SELECTED_FEATURE para el parámetro entities_of_interest_input_type. | Record Set |
include_tracks_layer (Opcional) | Especifica si se generará una capa de salida que contenga el primer evento de trazado y todas las entidades subsiguientes para esa entidad especificada.
| Boolean |
max_trace_depth | Los grados máximos de separación entre una entidad de interés y una entidad más abajo en el trazado (aguas abajo). | Long |
attribute_match_criteria [attribute_match_criteria,...] (Opcional) | Los campos utilizados para restringir el evento de proximidad. | Field |
data_store (Opcional) | Especifica el ArcGIS Data Store en el que se guardará la salida. La predeterminada es SPATIOTEMPORAL_DATA_STORE. Todos los resultados almacenados en un big data store espaciotemporal se almacenarán en WGS84. Los resultados almacenados en un data store relacional mantendrán su sistema de coordenadas.
| String |
Salida derivada
| Nombre | Explicación | Tipo de datos |
| output | La capa que contiene eventos de proximidad trazados. | Conjunto de entidades |
| tracks_layer | La capa opcional que contiene el primer evento de trazado en los recorridos y todas las entidades subsiguientes. | Conjunto de entidades |
Muestra de código
El siguiente script independiente muestra cómo utilizar la herramienta TraceProximityEvents.
# Name: TraceProximityEvents.py
# Description: Trace proximity events for user1 and user4 with 30 feet
# spatial search distance and 10 minute temporal search distance.
# Import system modules
import arcpy
inFeatures = "https://analysis.mydomain.com/server/rest/services/sample_tracks/FeatureServer/0"
entityIDField = "user_id"
outFS = "ProximityEvents"
spatialDistance = "30 Feet"
temporalDistance = "10 Minutes"
entitiesOfInterest = "user1 '3/30/2020 9:00:00 AM';user4 '3/30/2020 9:00:00 AM'"
outTracks = "out_tracks"
max_trace_depth = 3
dataStore = "SPATIOTEMPORAL_DATA_STORE"
# Execute Trace Proximity Events
arcpy.geoanalytics.TraceProximityEvents(inFeatures, entityIDField, outFS,
"PLANAR", spatialDistance,
temporalDistance, "ID_START_TIME",
entitiesOfInterest, None, "TRACKS",
None, None, max_trace_depth, dataStore)Entornos
- Sistema de coordenadas de salida
El sistema de coordenadas que se usará para el análisis. El análisis se completará en el sistema de coordenadas de entrada salvo que este parámetro especifique otra opción. Para las GeoAnalytics Tools, los resultados finales se almacenarán en el data store espaciotemporal en WGS84.
Información de licenciamiento
- Basic: Requiere ArcGIS GeoAnalytics Server
- Standard: Requiere ArcGIS GeoAnalytics Server
- Advanced: Requiere ArcGIS GeoAnalytics Server