Detectar incidentes

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

La herramienta Detectar incidentes 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

Diagrama del flujo de trabajo de la herramienta Detectar incidentes

Ejemplos

  • Cada vehículo de una flota envía su ubicación y velocidad actual a intervalos regulares. Si la velocidad reportada de un vehículo supera el límite de velocidad indicado para la ubicación indicada, Detectar incidentes abre un incidente. Para cada observación posterior reportada por el vehículo, si su velocidad actual sigue superando el límite de velocidad, el incidente se mantiene en un estado abierto. 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 continúa reportando un incidente abierto cada vez que el sensor indica 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 enriquece 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. Detectar incidentes abre un incidente en función de la proximidad del camión al túnel y sus atributos de carga actuales. 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. Detectar incidentes abre un incidente cuando el vehículo se sale del área asignada y cierra el incidente cuando el vehículo vuelve al área.

Notas de uso

  • Se requiere el parámetro Condición de apertura; sin embargo, el parámetro Condición de cierre es opcional. Si no se establece explícitamente una condición de cierre, el valor lógico NOT de la condición de apertura se utiliza implícitamente como condición de cierre. Una excepción es que, si se especifica un valor para Relación espacial como Entrada o Salida, el valor implícito de Condición de cierre es Salida o Entrada, respectivamente.
  • En un análisis en tiempo real, si el valor de Relación espacial se establece en Entrada o Salida, para los parámetros Condición de apertura o Condición de cierre, la herramienta operará con estados. Permite comparar las observaciones secuenciales entre sí para detectar un cambio de estado, por ejemplo, si una condición actual es distinta de la de la observación anterior. Con otras relaciones espaciales en análisis en tiempo real, la herramienta no necesita comparar ninguna observación con las anteriores para que se pueda ejecutar sin estado, lo cual consume 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 reemplazará la observación actual del almacén de estado por la nueva observación, la nueva observación no se agregará al almacén de estado y las futuras observaciones de este Id. de rastreo se compararán con la observación actual que permanezca en el almacén de estado hasta que llegue una nueva observación con una marca de tiempo posterior. La herramienta registrará una advertencia cuando esto suceda.
  • La herramienta tiene dos entradas; sin embargo, el parámetro Capa de unión solo es necesario si se elige Relación espacial para los parámetros Condición de apertura o Condición de cierre.
  • Los parámetros Condición de apertura y Condición de cierre se especifican mediante expresiones de Arcade. Para obtener una descripción general de las expresiones y funciones compatibles de Arcade, consulte la documentación de ArcGIS Arcade.
  • En un análisis en tiempo real, si el parámetro Cerrar en expiración se establece en , cualquier incidente abierto se cierra cuando caduca el tiempo definido en Ventana de tiempo de destino. Si se establece en No, se descartan todos los incidentes abiertos.
  • Para el parámetro Condición de apertura, si se elige Relación espacial y se utiliza el operador espacial Entrada o Salida, al activar la casilla de verificación La primera observación puede desencadenar la entrada o La primera observación puede desencadenar la salida, se indica 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 la entrada, o fuera de todas las entidades de unión en el caso de la salida, 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 un análisis en tiempo real, el valor del parámetro Ventana de tiempo de destino debe ser siempre al menos tan largo como el intervalo más largo esperado entre observaciones de un recorrido determinado. Las observaciones anteriores a esta duración se eliminarán de la memoria para administrar los recursos.
  • 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 realiza dinámicamente en función de 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 etiquetado como el campo clave Hora de finalización y la última observación conocida de una entidad de unión es más antigua que esta ventana, se purgará de la memoria de la herramienta y no se incluirá en el análisis. Si el feed de unión tiene un campo etiquetado como el campo clave Hora de finalización, la entidad se descarta por antigüedad del almacén de barreras geográficas de acuerdo con el valor del campo etiquetado como Hora de finalización o al cerrar la ventana de tiempo de unión, lo que ocurra primero.
  • Si se están utilizan barreras geográficas dinámicas, las expresiones de Arcade solo son válidas para la entidad de destino.

Parámetros

ParámetroDescripciónTipo de datos

Capa de entrada

Las entidades para las que se detectarán incidentes utilizando condiciones de apertura y cierre.

Entidades

Capa de unión (opcional)

Puede elegir con qué dataset desea procesar una relación espacial como parte de una condición de apertura o 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.

  • Relación espacial: especifica los criterios utilizados para filtrar espacialmente las entidades de destino. El parámetro solo aparece si se ha conectado un dataset al puerto de join. Los operadores espaciales son Inconexo, Entrada, Es igual a, Salida, Cerca de geodésico, Cerca de planar, Toca y Dentro de.
  • La primera observación puede desencadenar la entrada y La primera observación puede desencadenar la salida: están habilitados si se eligen Entrar o Salir como relación espacial e indican que la primera entidad de destino recibida puede abrir un incidente si está dentro de cualquier entidad de unión (en el caso de Entrada) o fuera de todas las entidades de unión (en el caso de Salida), aunque no tenga ninguna entidad de destino anterior con la que comparar la ubicación actual de la entidad de destino. El valor predeterminado es false (no activado).
  • Campos de unión (opcional) (sólo análisis en tiempo real): especifica los campos de la capa de unión que se agregarán a las entidades de destino. Por ejemplo, si se elige un campo TUNNEL_ID como campo de unión, el esquema de salida incluirá el campo TUNNEL_ID y sus valores. Si se detecta un incidente en un túnel con un TUNNEL_ID de 10, este valor se agrega al campo en la entidad de destino. Si se especifica una condición de cierre con entidades espaciales relevantes, los campos y valores también se unen a la entidad de destino. Si se especifica algún campo de unión que enriquezca datos de entidades espaciales relevantes mediante la relación espacial inconexa, los valores de campo se establecerán como nulos.
  • Expresión: una expresión de atributo que se debe evaluar para filtrar los datos entrantes. Las expresiones de atributos se especifican mediante expresiones de Arcade.
  • Hacer coincidir todas las condiciones de apertura: si se deben cumplir todas las condiciones espaciales, temporales y de atributos para abrir un incidente. Si se elige No, cualquiera de las condiciones será suficiente para abrir un incidente.

Nota:

Una entidad de destino debe satisfacer su relación espacial contra todas las entidades de unión cuando se ha especificado una inconexión o salida y hay más de una entidad de unión. En el caso de cualquier otra relación espacial y en el que haya más de una entidad de unión, una entidad de destino puede satisfacer su relación espacial con cualquier entidad de unión individual.

Parámetros

Condición de cierre (opcional)

Conjunto de condiciones que definen el final de un incidente. Al igual que Condición de apertura, puede incluir una condición espacial, un rango de tiempo y un conjunto de expresiones de atributos.

  • 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 son Inconexo, Entrada, Es igual a, Salida, Cerca de geodésico, Cerca de planar, Toca y Dentro de.
  • Expresión: una expresión de atributo que se debe evaluar para filtrar los datos entrantes. Las expresiones de atributos se especifican mediante expresiones de Arcade.
  • Hacer coincidir todas las condiciones de apertura: si se deben cumplir todas las condiciones espaciales, temporales y de atributos para abrir un incidente. Si se elige No, cualquiera de las condiciones será suficiente para abrir un incidente.
Nota:

Una entidad de destino debe satisfacer su relación espacial contra todas las entidades de unión cuando se ha especificado una inconexión o salida y hay más de una entidad de unión. En el caso de cualquier otra relación espacial y en el que haya más de una entidad de unión, una entidad de destino puede satisfacer su relación espacial con cualquier entidad de unión individual.

Parámetros

Devolver solo incidentes

Devolver solo las observaciones relacionadas con un incidente () o todas las observaciones (No).

Booleano

Campos TRACK_ID (solo análisis de big data)

Elija los campos para identificar de forma única las entidades que se desea procesar. El parámetro se rellenará automáticamente si se establece un campo clave Id. de rastreo en la capa de entrada.

Campos

Ventana de tiempo de destino (solo análisis en tiempo real)

Como mínimo, cambie la ventana de tiempo al intervalo más largo esperado entre las observaciones de un recorrido determinado. Las observaciones anteriores a esta duración se eliminarán de la memoria para administrar los recursos.

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 purga y no se incluye en el análisis. Si el feed de unión presenta un campo etiquetado como Hora de finalización, este parámetro es opcional.

Cadena de caracteres

Cerrar en expiración (solo análisis en tiempo real)

Si se establece en , cualquier incidente abierto se cerrará cuando caduque el tiempo definido para la Ventana de tiempo de destino. Si se establece en No, se descartarán todos los incidentes abiertos.

Booleano

Capa de salida

La capa de salida tendrá el esquema de las entidades entrantes y se enriquecerá con los campos siguientes.

Nombre de campoDescripciónTipo de campo

IncidentID

El identificador único del incidente.

Cadena de caracteres

IncidentStatus

El estado actual del incidente, incluidos Iniciado y Finalizado.

Cadena de caracteres

IncidentDuration

El número de milisegundos que estuvo abierto el incidente.

Entero