Elipse Knowledgebase

Descrição:

Como calcular a média de um tag que vem do histórico dentro de uma faixa de data/hora inicial/final?

Solução:

Para calcular a média de uma faixa de data/hora de um histórico, basta utilizar a função average.

Average (src, type, startTime [, endTime])

Retorna a média de um conjunto de dados do histórico. O parâmetro src determina o nome do tag que é gravado no histórico. O parâmetro type determina o intervalo de tempo a ser considerado para calcular a média, que pode ser o seguinte:

Intervalos de tempo
0 - Ano
1 - Mês
2 - Semana
3 - Dia
4 - Hora
5 - Minuto

O parâmetro startTime determina o tempo inicial da média. O parâmetro endTime (opcional) determina o tempo final da média. Se ele for utilizado, o parâmetro Type é ignorado.

Em termos práticos, basta utilizar o script abaixo:

Hist1.Open()
media = Hist1.Average("tag001",1,DataIni,DataFin)
Hist1.Close()

Onde:

• Hist1 é o histórico que estamos utilizando
• Media é um TagRam onde iremos guardar o valor calculado da média
• tag001 é o nome do tag que desejamos calcular a média
• DataIni é um TagRam com o valor da data e hora iniciais, formato dd/mm/yyyy hh:mm:ss
• DataFin é um TagRam com o valor da data e hora finais, formato dd/mm/yyyy hh:mm:ss

Ou seja, primeiro, abrimos o histórico com o comando Hist1.Open(). Feito isso, atribuímos o tag ram media à função average. Após o cálculo, fechamos o histórico com o Hist1.Close().

Atente que, neste exemplo, media, DataIni e DataFin são tags RAM. Para setar as faixas de data/hora, basta incluir setpoints na sua tela, associando as respectivas tags, e colocá-los no formato Data Hora.