Detectar incidentes

Disponible en análisis en tiempo real y de big data.

La herramienta Detectar incidentes evalúa las entidades utilizando un conjunto de condiciones de apertura y condiciones de cierre opcionales y crea un incidente único para cada conjunto continuo de observaciones que cumplan las condiciones.

Diagrama de flujo de trabajo

Ejemplos

A continuación, se muestran ejemplos de uso de la herramienta Detectar incidentes:

• Cada vehículo de una flota envía su ubicación y velocidad a intervalos regulares. Si la velocidad reportada de un vehículo supera el límite de velocidad indicado para la ubicación indicada, la herramienta Detectar incidentes abre un incidente. Para cada observación posterior reportada por el vehículo, si su velocidad sigue superando el límite de velocidad, el incidente se mantiene en un estado en curso. Cuando el vehículo informa de su velocidad dentro del límite de velocidad indicado, el incidente se cierra.
• Un sensor de presión en una secuencia que informa de la presión medida actual en una válvula, indica una presión fuera del rango operativo normal. Detectar incidentes abre un incidente y el incidente se mantiene en un estado en curso mientras el sensor indique que la presión está fuera del rango normal. Cuando la presión vuelve a ser normal, el incidente se cierra.
• Un convoy de camiones se acerca a un túnel en el que los vehículos que transportan materiales peligrosos están prohibidos. Cada vehículo informa de su ubicación y ArcGIS Velocity actualiza la información entrante de cada vehículo en función del manifiesto actual de su carga. Uno de los camiones está transportando oxidantes que se consideran peligrosos. Se abre un incidente en función de la proximidad del camión al túnel y sus atributos de carga. Cuando el camión se aleja del túnel, se cierra el incidente.
• Un vehículo de reparto asignado a un área de ruta especificada se encuentra fuera del área durante un período de tiempo. Se abre un incidente cuando el vehículo se sale del área asignada y se cierra cuando el vehículo vuelve al área.

Notas de uso

Tenga en cuenta lo siguiente al trabajar con la herramienta Detectar incidentes:

• Se requiere el parámetro Condición de apertura; sin embargo, el parámetro Condición de cierre es opcional. Si no se configura de forma explícita el valor del parámetro Condición de cierre, el operado lógico NOT del parámetro Condición de apertura se utiliza como condición de cierre.
  • Si la opción Relación espacial se configura en Interseca, el valor de Condición de cierre implícito es Inconexa.
  • Si la opción Relación espacial se configura en Entrar o Salir, el valor de Condición de cierre implícito es Salir o Entrar, respectivamente.
• En el análisis en tiempo real, esta herramienta funciona con estados cuando se utiliza Entrar o Salir para Relación espacial en Condición de apertura o Condición de cierre. Durante el funcionamiento con estados, la herramienta puede comparar observaciones secuenciales para detectar un cambio de estado entre observaciones. Esta herramienta se ejecuta con estados cuando se utilizan otras opciones de relación espacial, pero no necesita comparar las observaciones actuales con las anteriores. La ejecución sin estados consume muchos menos recursos.
• Cuando funciona con estados, la herramienta Detectar incidentes conserve un almacén de estado de la observación actual para cada Id. de rastreo. Cuando se recibe una nueva observación, se compara con la observación actual del mismo Id. de rastreo, si está presente. Si la nueva observación tiene una marca de tiempo más reciente que la observación actual en el almacén de estado, se sustituye la observación actual. Si tiene una marca de tiempo idéntica a la observación actual para el mismo Id. de rastreo, la herramienta no distingue entre ambas observaciones. Significa que la herramienta no reemplaza la observación actual del almacén de estado por la nueva observación, la nueva observación no se agrega al almacén de estado y las futuras observaciones de este Id. de rastreo se comparan con la observación actual que ha permanecido en el almacén de estado hasta la llegada de una nueva observación con una marca de tiempo posterior. La herramienta registra una advertencia cuando ocurre esto.
• La herramienta tiene dos entradas; sin embargo, el parámetro Datos de unión solo está disponible si se elige Relación espacial para los parámetros Condición de apertura o Condición de cierre.
• Se puede configurar una expresión de Arcade para los parámetros Condición de apertura o Condición de cierre.
• En un análisis en tiempo real, si el parámetro Cerrar en expiración se establece en Sí, cualquier incidente abierto se cierra cuando caduca el tiempo definido en Ventana de tiempo de destino. Si se establece en No, los incidentes abiertos permanecen abiertos. Si el tiempo configurado en Ventana de tiempo de destino expira, se crea un incidente nuevo si se cumple la relación espacial o la expresión de atributos del parámetro Condición de apertura.
• En el parámetro Condición de apertura, si elige Relación espacial y utiliza el operador espacial Entrar o Salir, puede activar la casilla de verificación La primera observación puede desencadenar la entrada o La primera observación puede desencadenar la salida para indicar que la primera entidad de destino recibida o procesada para cada Id. de rastreo puede abrir un incidente si está dentro de cualquier entidad de unión en el caso de Entrar o fuera de todas las entidades de unión en el caso de Salir, a pesar de que no haya una entidad de destino anterior con la que comparar la ubicación actual de la entidad de destino. El valor predeterminado no está activado.
• En el análisis en tiempo real, el parámetro Ventana de tiempo de destino debería configurarse en la mayor duración de tiempo que un incidente debería permanecer abierto o más. Las observaciones anteriores a esta duración se eliminan de la memoria para administrar los recursos. Se recomienda configurar el valor para que sea más alto que la duración más larga prevista del incidente. Por ejemplo, si se espera que el mayor tiempo que un incidente permanezca abierto sea 20 horas, este valor podría configurarse en 24 horas para garantizar que ningún incidente se cierre de forma prematura.
• El valor IncidentDuration que se calcula para los incidentes de salida se expresa en milisegundos.
• Si un feed está conectado al puerto de unión, la detección de incidentes se basa en las entidades cambiantes de los feeds de unión y de destino.
• Cuando se realizan barreras geográficas dinámicas, se debe definir el parámetro Ventana de tiempo de unión. Si el feed de unión no tiene un campo clave especificado en la opción Hora de finalización y la última observación conocida de una entidad de unión es más antigua que esta ventana, se elimina de la memoria de la herramienta y se excluye del análisis. Si el feed de unión tiene un campo clave especificado en la opción Hora de finalización, la entidad caduca en el almacén de barreras geográficas de acuerdo con el valor del campo que es la hora de finalización o al cerrar la ventana de tiempo de unión, lo que ocurra primero.
• Cuando se utilizan barreras geográficas dinámicas, las expresiones de Arcade solo son válidas para la entidad de destino.
• En la siguiente tabla se describen los métodos de relación espacial disponibles en función de los tipos de geometría entrada y unión:

Tipos de geometría de entrada y unión	Contiene	Cruza	Inconexa	Intro	Es igual a	Salir	Interseca	Cerca de geodésico	Cerca de planar	Superpone	Toca	Dentro de
Punto y punto
Punto y polilínea
Punto y polígono
Polilínea y punto
Polilínea y polilínea
Polilínea y polígono
Polígono y punto
Polígono y polilínea
Polígono y polígono

Parámetros

A continuación, se indican los parámetros de la herramienta Detectar incidentes:

Parámetro	Descripción	Tipo de datos
Datos de destino	Datos para los que se detectan incidentes mediante los parámetros Condición de apertura y Condición de cierre.	Entidades
Datos de unión (opcional)	Datos que se van a utilizar con una relación espacial en los parámetros Condición de apertura o Condición de cierre.	Entidades
Condición de apertura	Conjunto de condiciones que definen el inicio de un incidente. Con ello, puede incluir una condición espacial, un rango de tiempo y un conjunto de expresiones de atributos. Rango de tiempo (solo análisis de big data): especifica el rango de tiempo utilizado para detectar incidentes. Relación espacial: especifica los criterios utilizados para detectar incidentes espacialmente. Esta opción solo aparece si se ha conectado un dataset al puerto de join. Los operadores espaciales incluyen lo siguiente: Inconexa: si una geometría no se interseca con otra geometría. Entrar: si una geometría entra en el espacio de otra geometría. Igual: si las geometrías básica y de comparación pertenecen al mismo tipo de forma. Salir: si una geometría se desplaza fuera del espacio ocupado por otra geometría. Cerca de geodésico: si una geometría está cerca de un vértice o eje dentro de una distancia geodésica dada de otra geometría. Cerca de planar: si una geometría está cerca de un vértice o eje dentro de una distancia planar dada de otra geometría. Toca: si una geometría toca otra geometría cuando tienen un vértice de intersección, pero las geometrías no se superponen. Contiene: si una geometría contiene otra geometría. Cruza: si dos geometrías se intersecan en una geometría de un tipo de forma menor. Se interseca: si una geometría se interseca con otra geometría. Se superpone: si una geometría solapa otra. Ninguna: si no existe ninguna relación espacial entre dos geometrías. Dentro de: si una geometría está completamente dentro de otra. La primera observación puede desencadenar la entrada/salida: esta opción está disponible si se elige Entrar o Salir para una relación espacial. Esto indica que la primera entidad de destino recibida puede abrir un incidente, a pesar de no tener ninguna entidad de destino anterior con la que comparar la ubicación de la entidad de destino actual. En el caso de Entrar, el incidente se abre si la entidad de destino está dentro de cualquier entidad de unión. Con Salir, el incidente se abre si la entidad de destino está fuera de cualquier entidad de unión. En ambos casos, el valor predeterminado no está activado. Campos de unión (opcional) (solo análisis en tiempo real): especifica los campos de las entidades de unión que se agregan a las entidades de destino. Los campos elegidos como campos de unión están presentes en el esquema de salida. Cuan do se utiliza la relación espacial inconexa, los valores de campo se configuran en nulo. Expresión de Arcade: expresión de atributos que establece los criterios de los incidentes. Hacer coincidir todas las condiciones de apertura: si es Sí, se deben cumplir todas las condiciones espaciales, temporales y de atributos para abrir un incidente. Si es No, cualquiera de las condiciones es suficiente para abrir un incidente. Nota: Cuando se utiliza Inconexa o Salir como relación espacial del parámetro Condición de apertura, las entidades de destino deben estar completamente separadas de cualquier entidad desde el origen del parámetro Datos de unión para que se abra un incidente. En el caso de las demás opciones de relación espacial, la entidad de destino solo necesita satisfacer la relación espacial con cualquiera de las entidades desde el origen del parámetro Datos de unión para abrir un incidente.	Parámetros
Condición de cierre (opcional)	Conjunto de condiciones que definen el final de un incidente. Al igual que ocurre con el parámetro Condición de apertura, puede incluir una condición espacial, un rango de tiempo y un conjunto de expresiones de atributos. Rango de tiempo (solo análisis de big data): especifica el rango de tiempo utilizado para detectar incidentes. Relación espacial: define los criterios utilizados para filtrar espacialmente las entidades de destino. Este parámetro solo aparece si se ha conectado un dataset al puerto de join. Los operadores espaciales incluyen lo siguiente: Inconexa: si una geometría no se interseca con otra geometría. Entrar: si una geometría entra en el espacio de otra geometría. Igual: si las geometrías básica y de comparación pertenecen al mismo tipo de forma. Salir: si una geometría se desplaza fuera del espacio ocupado por otra geometría. Cerca de geodésico: si una geometría está cerca de un vértice o eje dentro de una distancia geodésica dada de otra geometría. Cerca de planar: si una geometría está cerca de un vértice o eje dentro de una distancia planar dada de otra geometría. Toca: si una geometría toca otra geometría cuando tienen un vértice de intersección, pero las geometrías no se superponen. Contiene: si una geometría contiene otra geometría. Cruza: si dos geometrías se intersecan en una geometría de un tipo de forma menor. Se interseca: si una geometría se interseca con otra geometría. Se superpone: si una geometría solapa otra. Ninguna: si no existe ninguna relación espacial entre dos geometrías. Dentro de: si una geometría está completamente dentro de otra. Expresión de Arcade: expresión de atributos que necesita evaluarse para detectar incidentes. Hacer coincidir todas las condiciones de cierre: si es Sí, se deben cumplir todas las condiciones espaciales, temporales y de atributos para cerrar un incidente. Si es No, basta con cumplir cualquiera de las condiciones para cerrar un incidente. Nota: Cuando se utiliza Inconexa o Salir como relación espacial del parámetro Condición de cierre, las entidades de destino deben estar completamente separadas de cualquier entidad desde el origen del parámetro Datos de unión para que se abra un incidente. En el caso de las demás opciones de relación espacial, la entidad de destino solo necesita satisfacer la relación espacial con cualquiera de las entidades desde el origen del parámetro Datos de unión para abrir un incidente.	Parámetros
Devolver solo incidentes	Sí: devuelve las observaciones relacionadas con un incidente solamente. No: devuelve todas las observaciones.	Booleano
Rastreo	Campos utilizados para identificar de manera exclusiva entidades para procesar. Si la capa de entidades de destino tiene un campo de Id. de rastreo especificado, el valor de Id. de rastreo se configura automáticamente.	Campos
Ventana de tiempo de destino (solo análisis en tiempo real)	Las observaciones anteriores a esta duración se eliminan de la memoria para administrar los recursos. Este valor debe configurarse en la duración máxima que un incidente debe permanecer abierto o más. Se recomienda configurar este valor para que sea más alto que el tiempo más largo previsto del incidente.	Cadena de caracteres
Ventana de tiempo de unión (solo análisis en tiempo real)	La ventana de tiempo del feed de unión (barreras geográficas dinámicas). Si la última observación conocida de una entidad de unión es más antigua que la ventana de tiempo especificada, se elimina y no se incluye en el análisis. Si el feed de unión presenta un campo clave especificado para la opción Hora de finalización, este parámetro es opcional. Nota: Este parámetro solo está disponible si la capa de destino y la capa de unión son feeds.	Cadena de caracteres
Cerrar en expiración (solo análisis en tiempo real)	Sí: cualquier incidente abierto se cierra cuando expira la Ventana de tiempo de destino. No: cualquier incidente abierto permanece abierto al expirar el valor de Ventana de tiempo de destino. Al caducar el valor de Ventana de tiempo de destino, se crea un incidente nuevo si se cumple la relación espacial o la expresión de atributos.	Booleano

Capa de salida

La capa de salida tiene el esquema de las entidades entradas, además de los campos siguientes:

Nombre de campo	Descripción	Tipo de campo
IncidentID	El identificador único del incidente.	Cadena de caracteres
IncidentStatus	Estado actual del incidente. El estado puede ser Iniciado, En curso o Finalizado.	Cadena de caracteres
IncidentDuration	Cantidad de milisegundos que el incidente está abierto.	Entero