Operadores históricos de observação são operadores utilizados para obter estatísticas sobre os pontos da grade, produzindo um novo valor da grade de saída.

A Figura 3.31 ilustra um conjunto de dados matriciais dinâmicos coletados sistematicamente que são utilizados para obter um novo valor em cada ponto da grade a partir de um operador escolhido pelo usuário, como por exemplo calcular o mínimo, máximo, média etc.


Figura 3.31 – Análise com base em dados matriciais: Uso de operadores sobre grades dinâmicas de observação.


Estes operadores são divididos em dois tipos: Histórico e Histórico por Intervalo. A descrição de cada tipo a seguir.



1- Histórico

Grupo de operadores que retornam valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

SINTAXE GERAL:

grid.history.<operator>("<dynamic_data_grid>", "<time>", [<band>])  

onde:

  • operator : min, max, mean, sum, median, standard_deviation, variance; 
  • dynamic_data_grid : String com o nome da série de dados matriciais .
  • time : String com o intervalo de tempo, a partir da hora atual. Ver utilitário  Unidades de tempo.
  • band : [Opcional] Banda da grade utilizada. Se não informado será considerado a primeira banda (0).


Segue a descrição de cada operador.

Histórico : Mínimo

Retorna os menores valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.min(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.min("chuva", "1d", 0)

Histórico : Máximo

Retorna os maiores valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.max(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.max("chuva", "1d", 0)

Histórico : Média

Retorna as médias dos valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.mean(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.mean("chuva", "1d", 0)

Histórico : Soma

Retorna as somas em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.sum(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.sum("chuva", "1d", 0)

Histórico : Mediana

Retorna as medianas em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.median(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.median("chuva", "1d", 0)

Histórico : Desvio Padrão

Retorna os desvios padrões em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.standard_deviation(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.standard_deviation("chuva", "1d", 0)

Histórico : Variância

Retorna as variâncias em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo definido entre a data/hora atual e o valor de tempo informado no passado.

Sintaxe:

grid.history.variance(“<dynamic_data_grid>”, “<time>”, [<band>])

Exemplo:        x = grid.history.standard_deviation("chuva", "24h", 0)



2- Histórico por intervalo

Grupo de operadores que retornam os valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

SINTAXE GERAL:

grid.history.interval.<operator>("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])  

onde:

  • operator : min, max, mean, median, sum, standard_deviation, variance; 
  • dynamic_data_grid : String com o nome da série de dados matriciais;
  • time_begin : String inicial (mais antigo) do intervalo de tempo para filtrar as grades. Este valor será aberto (< tempo mais antigo) no tempo informado;
  • time_end : String final (mais recente) do intervalo de tempo para filtrar as grades. Este valor será fechado ( <= tempo mais recente) no tempo informado;
  • band : [Opcional] Banda da grade a ser utilizada. Se não informado será considerado a primeira banda (0);

Segue a descrição de cada operador.

Histórico por intervalo : Mínimo

Retorna os menores valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.min("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.min("chuva", "10d", “5d”, 0)

Histórico por intervalo : Máximo

Retorna os maiores valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.max("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.max("chuva", "10d", “5d”, 0)

Histórico por intervalo : Média

Retorna as médias dos valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.mean("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.mean("chuva", "10d", “5d”, 0)

Histórico por intervalo : Mediana

Retorna as medianas dos valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.median("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.median("chuva", "10d", “5d”, 0)

Histórico por intervalo : Soma

Retorna as somas dos valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.sum("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.sum("chuva", "10d", “5d”, 0)

Histórico por intervalo : Desvio padrão

Retorna os desvios padrões dos valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.standard_deviation("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.standard_deviation("chuva", "10d", “5d”, 0)

Histórico por intervalo : Variância

Retorna as variâncias dos valores em cada ponto da grade sobre dados matriciais históricos no intervalo de tempo inicial e final informado no passado em relação a data/hora atual.

Sintaxe:

                  1. grid.history.interval.variance("<dynamic_data_grid>", "<time_begin>", "<time_end>", [<band>])

Exemplo:        x = grid.history.interval.variance("chuva", "10d", “5d”, 0)