8 Funcions predictives

Totes les funcions llistades aquí són compatibles amb:

• Expressions trigger
• Elements calculats

Les funcions es llisten sense informació addicional. Feu clic a la funció per veure'n tots els detalls.

Paràmetres comuns

• /host/key és un paràmetre comú obligatori per les funcions sobre l'històric de l'element d'equip
• (sec|#num)<:time shift> és un segon paràmetre habitual per funcions referents a l'històric de l'element d'equip, on:
  • sec - període d'avaluació màxim en segons (es poden emprar els sufixes), o
  • #num - període d'avaluació màxim en nombre de valors recollits (si van precedits per el símbol de la graella)
  • canvi horari (facultatiu) permet canviar el punt d'avaluació en el temps. Veieu més detalls sobre la especificació del canvi horari.

Detalls de la funció

Algunes notes generals sobre paràmetres de funció:

• Els paràmetres de funció són separats per una coma
• Els paràmetres de funció opcionals (o parts de paràmetres) s'indiquen amb < >
• Els paràmetres específics de la funció es descriuen amb cada funció
• Els paràmetres /host/key i (sec|#num)<:time shift> no s'han de citar mai entre cometes

previsió(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)

El valor futur, màxim, mínim, delta o mitjana de l'element.
Tipus de valors admesos: Flotant, Enter.

Paràmetres:

• Veieu paràmetres comuns;
  
• temps - l'horitzó de previsió en segons (es poden utilitzar sufixos de temps); els valors negatius són compatibles;
  
• ajustar (opcional; ha de ser entre cometes) - la funció que s'empra per ajustar les dades històriques. Ajustaments admesos:
  lineal - funció lineal (per defecte)
  polinomiN - polinomi de grau N (1 <= N <= 6)
  exponencial - funció exponencial
  logarítmica - funció logarítmica
  potència - funció de potència
  Tingueu en compte que polinomi1 és equivalent a lineal;
• mode (opcional; ha de ser entre cometes) - la sortida demanada. Modes admesos:
  valor - valor (predeterminat)
  max - màxim
  min - mínim
  delta - max-min
  mitjana - mitjana
  Tingueu en compte que valor estima el valor de l'article en el moment ara + hora; max, min, delta i avg investiguen l'estimació del valor de l'element en l'interval entre ara i ara + temps.

Comentaris:

-Si el valor a la retorn és superior a 1.7976931348623158e+308 o inferior a -1.7976931348623158e+308, el valor de retorn es retalla a 1.7976931348623158e+308 o -1.7976931348623158e+308 corresponent; - No s'admet només si s'utilitza malament a l'expressió (tipus d'element incorrecte, paràmetres no vàlids), en cas contrari retorna -1 en cas d'error; - Veieu també informació addicional sobre funcions d'activació predictiva.

Exemples:

forecast(/host/key,#10,1h) #previsió del valor de l'element en una hora basant-se en els darrers 10 valors
       forecast(/host/key,1h,30m) #forecast el valor de l'element en 30 minuts basant-se en les dades de l'última hora
       forecast(/host/key,1h:now-1d,12h) #previsió del valor de l'element en 12 hores basant-se en una hora fa un dia
       forecast(/host/key,1h,10m,"exponencial") #previsió del valor de l'element en 10 minuts basant-se en les dades de l'última hora i la funció exponencial
       forecast(/host/key,1h,2h,"polynomial3","max") #forecast el valor màxim que pot assolir l'element en les dues hores següents basat en les dades de l'última hora i el polinomi cúbic (tercer grau)
       forecast(/host/key,#2,-20m) #estima el valor de l'element fa 20 minuts en funció dels dos últims valors (això pot ser més precís que emprar last(), sobretot si l'element s'actualitza poques vegades, per exemple, una vegada una hora)

timeleft(/host/key,(sec|#num)<:time shift>,threshold,<fit>)

El temps en segons necessari perquè un element arribi al llindar especificat.
Tipus de valors admesos: Flotant, Enter.

Paràmetres:

• Veieu paràmetres comuns;
  
• llindar- el valor a assolir (es pot utilitzar sufixos d'unitat);
• ajustar (opcional; ha de ser entre cometes) - veieu previsió().

Comentaris:

• Si el valor a retornar és més gran que 1,7976931348623158E+308, el valor de retorn es retalla a 1,7976931348623158E+308;
• Retorna 1,7976931348623158E+308 si no es pot assolir el llindar;
• No s'admet només si s'utilitza malament a l'expressió (tipus d'element incorrecte, paràmetres no vàlids), en cas contrari retorna -1 en cas d'error;
• Vegeu també informació addicional sobre funcions d'activació predictiva.

Exemples:

timeleft(/host/key,#10,0) #el temps fins que el valor de l'element arriba a zero en funció dels darrers 10 valors
       timeleft(/host/key,1h,100) #el temps fins que el valor de l'element arriba a 100 segons les dades de l'última hora
       timeleft(/host/key,1h:now-1d,100) #el temps fins que el valor de l'element arriba a 100 basat en una hora fa un dia
       timeleft(/host/key,1h,200,"polinomi2") #el temps fins que el valor de l'element arriba a 200 segons les dades de l'última hora i la suposició que l'element es comporta com un polinomi quadràtic (segon grau)

Veieu totes les funcions admeses.