La herramienta Trazar eventos de proximidad traza eventos cercanos entre sí en el espacio (ubicación) y el tiempo. La capa de entrada debe tener puntos con el tiempo habilitado que representen un instante en el tiempo.
Diagrama de flujo de trabajo
Análisis mediante GeoAnalytics Tools
El análisis mediante GeoAnalytics Tools se ejecuta con el procesamiento distribuido en varios equipos y núcleos de ArcGIS GeoAnalytics Server. Las GeoAnalytics Tools y las herramientas de análisis de entidades estándar de ArcGIS Enterprise tienen parámetros y capacidades diferentes. Para obtener más información sobre las diferencias, consulte Diferencias de las herramientas de análisis de entidades.
Terminología
| Plazo | Definición | Ejemplo |
|---|---|---|
Entidad | Objeto móvil cuya posición se registra periódicamente. | Animal, persona o vehículo. Una entidad puede ser fija o móvil. |
Entidades de interés | Entidades específicas utilizadas para iniciar un trazado. | Persona con COVID-19. |
Evento de proximidad | Cuando dos entidades están cerca la una de la otra durante un periodo de tiempo. | Dos personas que están a menos de 3 metros entre sí y dentro de una ventana de 1 minutos entre sí. |
Profundidad | Grado de separación entre una entidad de interés y una entidad situada más abajo en el trazado (aguas abajo). | Un evento de proximidad entre la entidad de interés y otra persona es la profundidad 1. |
Evento de trazado | Primer contacto para una entidad especificada aguas abajo de las entidades de interés. |
Ejemplos
Una organización monitoriza los dispositivos proporcionados por la empresa a los trabajadores para su trabajo. 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 de piscifactoría 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.
Notas de uso
Al trazar eventos de proximidad, es su responsabilidad comprender las directrices organizativas, locales y nacionales relacionadas con la sensibilidad y privacidad de los datos.
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 Seleccionar uno o más atributos de entidad para cotejar para restringir los eventos de proximidad cuando sea necesario. Por ejemplo, utilice atributos para restringir la sala, la planta o la elevación.
Especificar una distancia de búsqueda temporal y una distancia de búsqueda espacial mayores resulta en más eventos y se tarda más tiempo en procesar los resultados. Las distancias más pequeñas generan menos eventos y el tiempo de procesamiento es más corto.
Las entidades deben cumplir los criterios de los parámetros Distancia de búsqueda espacial y Distancia de búsqueda temporal para que se consideren próximas entre sí.
 |  |
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.
La entidad de interés es donde comienza 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 empieza el 1 de enero de 1970 para esa entidad.
De forma predeterminada, se crean recorridos de entidad mediante un método geodésico para el cálculo de la distancia. Se recomienda utilizar la distancia geodésica en las siguientes circunstancias:
- Recorridos que cruzan la línea internacional de cambio de fecha: cuando se utiliza el método geodésico, las capas de entrada que cruzan la línea de fecha internacional tendrán recorridos que cruzarán correctamente la línea de fecha internacional. La capa de entrada o la referencia espacial de procesamiento deben estar definidas con una referencia espacial que admita el ajuste alrededor de la línea internacional de cambio de fecha, por ejemplo, una proyección global como proyección cilíndrica equivalente del mundo.
- Su dataset no se encuentra en una proyección local: si sus datos de entrada se encuentran en una proyección local, utilice el método de distancia planar. Por ejemplo, utilice el método planar para examinar los eventos de trazado de un mismo estado. La capa de entrada o la referencia espacial de procesamiento deben estar definidas con una referencia espacial local de su dataset.
Utilice Opciones avanzadas para especificar la profundidad de trazado máxima y los atributos de entidad para cotejar:
- 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 Seleccionar uno o más atributos de entidad para cotejar para especificar los atributos de restricción. Por ejemplo, para restringir entidades en la misma planta, especifique el campo Floor.
- De forma predeterminada, se buscan todos los trazados entre una entidad de interés y una entidad más abajo en el trazado. Utilice el parámetro Profundidad máxima de trazado para limitar la profundidad.
La capa de eventos de proximidad de salida contiene el primer evento de proximidad para las entidades del trazado, así como los siguientes campos:
- from_id—Id. de la entidad aguas arriba
- to_id—Id. de la entidad aguas abajo
- depth—Grado de separación entre la entidad de interés y el campo to_id
- duration_minutes—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—Fecha y hora del evento de proximidad Este campo se calcula como la primera hora registrada que cumple los criterios del evento de proximidad.
Puede visualizar la capa de eventos de proximidad de salida mediante el uso del control deslizante de tiempo o en un gráfico de vínculos de ArcGIS Pro si quiere visualizar los resultados del trazado.
Puede utilizar el parámetro opcional Incluir capa de rastreos para crear una capa que contenga el primer evento de trazado y todas las entidades posteriores para esa entidad. Además, las características de la entidad de interés siempre se incluyen en la capa de recorrido de salida. Estos resultados son útiles para visualizar por dónde se desplazaron las entidades y se pueden utilizar en la herramienta Reconstruir recorridos. La capa de recorridos de salida incluye los campos siguientes:
- entity_id—Id. de entidad
- depth—Grado de separación entre la entidad de interés y el recorrido del trazado La profundidad es la misma en un solo recorrido.
- instant_datetime—Fecha de cada entidad Es la misma fecha que el registro de las entidades de entrada.
Si Usar la extensión del mapa actual se ha activado, solo se analizarán las entidades que estén visibles en la extensión de mapa actual. Si está desactivada, se analizarán todas las entidades de entrada de la capa de entrada, aunque estén fuera de la extensión de mapa actual.
Limitaciones
Los eventos de proximidad de entrada deben estar en una capa de puntos con entidades con tiempo habilitado de tipo instante. Las entidades sin tiempo no se incluyen en los resultados de salida.
Cómo funciona Trazar eventos de proximidad
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 devuelve el evento 1 en la capa de eventos de proximidad. Los eventos de proximidad 2 y 3 no se devuelven. Si se selecciona el parámetro Incluir capa de rastreos, todas las entidades después del evento de proximidad 1 se devuelven en la capa de recorridos de salida.
Ejemplo de ArcGIS API for Python
La herramienta Trazar eventos de proximidad está disponible a través de ArcGIS API for Python.
En este ejemplo se encuentran los eventos de proximidad de todas las entidades en las capas de entrada que se aproximaron a una entidad denominada entity_3.
# Import the required ArcGIS API for Python modules
import arcgis
from arcgis.gis import GIS
# Connect to your ArcGIS Enterprise portal and confirm that GeoAnalytics is supported
portal = GIS("https://myportal.domain.com/portal", "gis_publisher", "my_password", verify_cert=False)
if not portal.geoanalytics.is_supported():
print("Quitting, GeoAnalytics is not supported")
exit(1)
# Search for and list the big data file shares in your portal
search_result = portal.content.search("", "Big Data File Share")
# Look through the search results for the big data file share of interest
bd_layer = next(x for x in search_result if x.title == "bigDataFileShares_EntityLocationPoints")
# Run the Trace Proximity Events tool
result = arcgis.geoanalytics.use_proximity.trace_proximity_events(input_points = bd_layer,
entity_id_field = "UniqueID",
entities_of_interest_ids = [{"entityId": "entity_3", "epochTimeStamp": None}],
spatial_search_distance = 6,
spatial_search_distance_unit = "feet",
distance_method = "Geodesic",
temporal_search_distance = 10,
temporal_search_distance_unit = "minutes",
max_trace_depth = None,
attribute_match_criteria = None,
include_tracks_layer = None,
output_name = "TPE_output")
# Visualize the results if you are running Python in a Jupyter Notebook
processed_map = portal.map()
processed_map.add_layer(result)
processed_map
Herramientas similares
Utilice Trazar eventos de proximidad para trazar eventos cercanos entre sí en el espacio (ubicación) y el tiempo. Existen otras herramientas que pueden resultar de utilidad para solucionar problemas similares, aunque ligeramente diferentes.
Herramientas de análisis del Map Viewer
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.
Si desea reconstruir puntos en las rutas recorridas o visualizar los recorridos de salida, utilice Reconstruir recorridos GeoAnalytics Tools.
Herramientas de análisis de ArcGIS Desktop
Trazar eventos de proximidad GeoAnalytics Tools también está disponible en ArcGIS Pro.
Para ejecutar la herramienta desde ArcGIS Pro, en el portal activo de su proyecto se debe estar ejecutando ArcGIS Enterprise 10.9 o posterior. A partir de la versión 10.9, debe iniciar sesión en el portal utilizando una cuenta que tenga privilegios para realizar análisis espaciales en el portal.