## Detectar incidentes

##

Esta herramienta funciona con una capa de puntos, líneas, áreas o tablas con la función de tiempo habilitada que representa un instante en el tiempo. Si utiliza entidades ordenadas secuencialmente, denominadas recorridos, esta herramienta determina qué entidades son incidentes de interés. Los incidentes se determinan atendiendo a las condiciones que usted especifique.

Primero, la herramienta determina qué entidades pertenecen a un recorrido utilizando uno o varios campos. Al utilizar la hora de cada entidad, los recorridos se ordenan secuencialmente y la condición del incidente se aplica. Las entidades que cumplan la condición inicial de incidente se marcan como incidentes. Opcionalmente, puede aplicar una condición final de incidente; cuando la condición final se cumpla, la entidad deja de ser un incidente. Los resultados se devolverán con las entidades originales (con columnas nuevas que representen el nombre del incidente) e indican qué entidad cumple la condición de incidente. Puede devolver todas las entidades originales o solo las entidades que sean incidentes.

Por ejemplo, supongamos que tiene mediciones de GPS de huracanes cada 10 minutos. Cada medición de GPS registra el nombre, la ubicación, la hora de registro y la velocidad del viento del huracán. Al utilizar estos campos, podría crear un incidente en el que toda medición con una velocidad de viento superior a los 208 km/h constituye un incidente denominado `Catastrófico`. Si no establece ninguna condición final, el incidente finalizaría si la entidad deja de cumplir la condición inicial (la velocidad del viento pasa a ser menor que 208).

Probemos con otro ejemplo: supongamos que está monitorizando las concentraciones de una sustancia química en su red local de suministro de agua con un campo denominado `contanimateLevel`. Sabe que los niveles recomendados son los inferiores a 0,01 mg/L, y que los niveles peligrosos son los superiores a 0,03 mg/L. Para detectar incidentes en los que un valor superior a 0,03 mg/L constituye un incidente y permanece como tal hasta que los niveles de contaminación vuelvan a ser normales, usted crea un incidente utilizando una condición inicial de `contanimateLevel > 0.03` y una condición final de `contanimateLevel < 0.01`. Con ello, se marcará toda secuencia cuyos valores superen los 0,03 mg/L hasta que vuelvan a ser inferiores a 0,01.

## Elegir una capa en la que detectar incidentes desde

Los puntos, líneas, áreas o tablas que se utilizarán para buscar incidentes. La capa de entrada debe tener habilitada la función de tiempo, con entidades que representen un instante en el tiempo, así como uno o varios campos que se puedan utilizar para identificar recorridos.

Además de elegir una capa en el mapa, puede elegir Examinar capas en la parte inferior de la lista desplegable para examinar el contenido del dataset o la capa de entidades de un archivo compartido de big data.

## Seleccionar uno o varios campos para identificar recorridos

Los campos que representan el identificador del recorrido. Puede utilizar uno o varios campos para representar valores únicos de recorridos.

Por ejemplo, si estuviera reconstruyendo recorridos de huracanes, podría utilizar el nombre del huracán como el campo del recorrido.

## Crear una condición de expresión para marcar el inicio de un incidente

Agregar una condición con el constructor de expresiones para determinar qué es un incidente. Si la condición que especifica se cumple, la entidad es un incidente. Si no especifica ninguna condición final, el incidente termina cuando la condición inicial ya no se cumple.

Por ejemplo, supongamos que quiere recibir una alerta cuando la suma de los campos `concentration_1` y `concentration_2` sea mayor que `concentration_3`. Para ello, aplique la condición de `($feature["concentration_1"] + $feature["concentration_2"]) > $feature["concentration_3"])`.

## Crear una condición de expresión para marcar el fin de un incidente

Opcionalmente, puede agregar una condición con el constructor de expresiones para determinar el final de un incidente. Si la condición que especifica se cumple, la entidad deja de ser un incidente. Si no especifica ninguna condición final, el incidente termina cuando la condición inicial ya no se cumple.

Por ejemplo, supongamos que quiere recibir una alerta cuando la suma de los campos `concentration_1` y `concentration_2` sea mayor que `concentration_3`, y quiere que el incidente finalice si `concentration_4` es menor que `concentration_1`. Para ello, aplique una condición inicial de `($feature["concentration_1"] + $feature["concentration_2"]) > ($join["income"] * .20)` y una condición final de `($feature["concentration_4"] < $feature["concentration_1"])`.

## Seleccionar cómo desea representar la salida

Todos los métodos de salida incorporarán campos a las entidades originales. Existen dos formas de determinar qué entidades se devuelven:

- Devolver solo incidentes: este método devolverá únicamente las entidades que sean incidentes. No se devolverán aquellas entidades que no se consideren incidentes.
- Devolver todas las entidades: esta es la opción predeterminada. Se devolverán todas las entidades de la entrada.

## Nombre de capa de resultados

Este es el nombre de la capa que se creará en Mi contenido y se agregará al mapa. El nombre predeterminado se basa en el nombre de la herramienta y en el nombre de la capa de entrada. Si la capa ya existe, la herramienta fallará.

En el cuadro desplegable Guardar el resultado en, puede especificar el nombre de una carpeta de Mi contenido en la que se guardará el resultado.