Áú»¢¶Ä²©

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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

• 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
  ±ô´Ç²µ²¹°ù¨ª³Ù³¾¾±³¦²¹ - funci¨® ±ô´Ç²µ²¹°ù¨ª³Ù³¾¾±³¦²¹
  ±è´Ç³Ù¨¨²Ô³¦¾±²¹ - funci¨® de ±è´Ç³Ù¨¨²Ô³¦¾±²¹
  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.

±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:

• Veieu par¨¤metres comuns;
  
• llindar- el valor a assolir (es pot utilitzar sufixos d'unitat);
• ajustar (opcional; ha de ser entre cometes) - veieu ±è°ù±ð±¹¾±²õ¾±¨®().

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.