## Detetar Incidentes

##

Esta ferramenta funciona com uma camada com componente temporal ativa, de pontos, linhas ou áreas ou tabelas que representem um instante no tempo. Ao utilizar elementos ordenados sequencialmente, a que chamamos trilhos, esta ferramenta determina que elementos são incidentes de interesse. Os incidentes são determinados por condições especificadas por si.

Primeiro, a ferramenta determina que elementos pertencem a um trilho, utilizando um ou mais campos. Utilizando a hora de cada elemento, os trilhos são ordenados sequencialmente e a condição de incidente é aplicada. Elementos que correspondem à condição incidente inicial são marcadas como um incidente. Opcionalmente, pode aplicar uma condição de incidente final; quando a condição de fim é verdadeira, o elemento deixa de ser um incidente. Os resultados serão devolvidos com os elementos originais—com novas colunas que representam o nome do incidente—e indicam que elemento corresponde à condição de incidente. Pode devolver todos os incidentes originais ou apenas os elementos que são incidentes.

Por exemplo, suponha que tem medições de GPS de furacões a cada 10 minutos. Cada medição de GPS regista o nome e localização do furacão, hora da gravação e a velocidade do vento. Utilizando estes campos, poderia criar um incidente em que qualquer medição com uma velocidade de vento superior a 208 km/h é um incidente denominado `Catastrófico`. Ao não definir uma condição de fim, o incidente terminaria se o elemento deixasse de corresponder à condição inicial (a velocidade do vento abranda para menos do que 208).

Recorrendo a outro exemplo, suponha que está a monitorizar concentrações de um produto químico no fornecimento de águal local, utilizando um campo chamado `contanimateLevel`. Sabe que os níveis recomendados são inferiores a 0,01 mg/L, e os níveis perigosos são superiores 0.03 mg/L. Para detetar incidentes em que um valor acima de 0.03mg/L é um incidente e mantém-se um incidente até que os níveis de contaminação voltem ao normal, criará um incidente utilizando uma condição inicial de `contanimateLevel > 0.03` e uma condição final de `contanimateLevel < 0.01`. Esta ação irá marcar qualquer sequência em que os valores excedem 0.03mg/L até que regressem a um valor inferior a 0.01.

## Selecionar camada na qual detetar incidentes

Os pontos, linhas, áreas ou tabelas que serão utilizados para encontrar incidentes. A camada de entrada tem de ter a compoenente temporal ativa com elementos que representam um instante no tempo, bem como ter um ou mais campos que podem ser utilizados para identificar trilhos.

Para além de selecionar uma camada do seu mapa, pode selecionar Explorar Camadas na parte inferior da lista pendente para navegar até aos seus conteúdos de um conjunto de dados de partilha de big data ou camada de elementos.

## Selecionar um ou mais campos para identificar trilhos

Os campos que representam o identificador de trilhos. Pode utilizar um campo ou vários campos para representar valores únicos de trilhos.

Por exemplo, caso estivesse a reconstruir trilhos de furacões, poderia utilizar os nome dos furacão como o campo de trilho.

## Construir uma condição de expressão para significar o início de um incidente

Adicione uma condição utilizando o builder de expressões para determinar o que é um incidente. Caso a condição que especificar seja verdadeira, o elemento será um incidente. Caso não especifique uma condição de fim, um incidente termina quando a condição inicial deixa de ser verdadeira.

Por exemplo, suponha que pretende ser alertado quando a soma dos campos `concentration_1` e `concentration_2` é superior a `concentration_3`. Para fazer isto, aplique uma condição de `($feature["concentration_1"] + $feature["concentration_2"]) > $feature["concentration_3"])`.

## Construir uma condição de expressão para significar o final de um incidente

Opcionalmente, adicione uma condição utilizando o builder de expressões para determinar o final de um incidente. Caso a condição de fim que especificar seja verdadeira, o elemento deixará de ser um incidente. Caso não especifique uma condição de fim, um incidente termina quando a condição inicial deixa de ser verdadeira.

Por exemplo, suponha que pretende ser alertado quando a soma dos campos `concentration_1` e `concentration_2` é superior a `concentration_3`, e pretenda que o incidente termine caso `concentration_4` seja inferior a `concentration_1`. Para fazer isto, aplique uma condição inicial de `($feature["concentration_1"] + $feature["concentration_2"]) > ($join["income"] * .20)` e uma condição de fim de `($feature["concentration_4"] < $feature["concentration_1"])`.

## Selecione como pretende que a saída seja representada

Todos os métodos de saída anexarão campos aos elementos originais. Existem duas formas de determinar que elementos são devolvidos:

- Devolver apenas incidentes—Este método devolverá apenas os elementos que são incidentes. Quaisquer elementos que não sejam incidentes não serão devolvidos.
- Devolver todos os elementos—É a predefinição. Todos os elementos da entrada serão devolvidos.

## Nome da camada resultante

Este é o nome da camada que será criada em O Meu Conteúdo e adicionada ao mapa. O nome padrão é baseado no nome da ferramenta e do nome da camada de entrada. Caso a camada já existe, a ferramenta irá falhar.

Ao utilizar a caixa suspensa Guardar resultado em pode definir o nome da pasta em O Meu Conteúdo onde o resultado será guardado.