Documentation
8 Funcions de predicci¨®
Totes les funcions llistades aqu¨ª s¨®n compatibles amb:
Les funcions es llisten sense informaci¨® addicional. Feu clic a la funci¨® per veure'n tots els detalls.
| ¹ó³Ü²Ô³¦¾±¨® | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨® |
|---|---|
| forecast | Valor futur, m¨¤xim, m¨ªnim, delta o mitjana de l'element. |
| timeleft | Temps en segons necessaris perqu¨¨ un element arribi al llindar especificat. |
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/keyi(sec|#num)<:time shift>no s'han de citar mai entre cometes
forecast(/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>)
Valors futur, m¨¤xim, m¨ªnim, delta o mitjana de l'element.
Tipus de valors admesos: Flotant, Enter.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
- Veieu par¨¤metres comuns;
- temps - llindar de previsi¨® en segons (es poden emprar sufixos de temps); els valors negatius s¨®n compatibles;
- ajustar (opcional; ha de ser entre cometes) - 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 esperada. 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 momentara+hora; max, min, delta i avg investiguen l'estimaci¨® del valor de l'element en l'interval entrearaiara+temps.
Comentaris:
- Si el valor a retornar ¨¦s superior a 1,7976931348623157E+308 o inferior a -1,7976931348623157E+308, el valor de retorn es retalla a 1,7976931348623157E+308 o -1,7976931348623157E+308;
- No s'admet nom¨¦s si s'empra 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 predictives de trigger.
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) #previsi¨® 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 la darrera hora i la funci¨® exponencial
forecast(/host/key,1h,2h,"polynomial3","max") #previsi¨® el valor m¨¤xim que pot assolir l'element en les dues hores seg¨¹ents en funci¨® de les dades de la darrera hora i del polinomi c¨²bic (tercer grau)
forecast(/host/key,#2,-20m) #estima el valor de l'element fa 20 minuts en funci¨® dels dos darrers valors (aix¨° pot ser m¨¦s prec¨ªs que emprar last(), sobretot si l'element s'actualitza poques vegades, per exemple, una cop l'hora)timeleft(/host/key,(sec|#num)<:time shift>,threshold,<fit>)
Temps necessari (en segons) perqu¨¨ un element arribi al llindar especificat.
Tipus de valors admesos: Flotant, Enter.
±Ê²¹°ù¨¤³¾±ð³Ù°ù±ð²õ:
- Veieu par¨¤metres comuns;
- llindar - el valor a assolir (es poden emprar sufixos d'unitat);
- ajustar (opcional; ha de ser entre cometes) - veieu ±è°ù±ð±¹¾±²õ¾±¨®().
Comentaris:
- Si el valor a retornar ¨¦s m¨¦s gran que 1,7976931348623157E+308, el valor de retorn es retalla a 1,7976931348623157E+308;
- Retorna 1.7976931348623157E+308 si no es pot assolir el llindar;
- No s'admet nom¨¦s si s'empra 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:
timeleft(/host/key,#10,0) #temps fins que el valor de l'element arriba a zero en funci¨® dels darrers 10 valors
timeleft(/host/key,1h,100) #temps fins que el valor de l'element arriba a 100 segons les dades de la darrera hora
timeleft(/host/key,1h:now-1d,100) #temps fins que el valor de l'element arriba a 100 basat en una hora fa un dia
timeleft(/host/key,1h,200,"polynomial2") #temps fins que el valor de l'element arriba a 200 segons les dades de la darreraa hora i la suposici¨® que l'element es comporta com un polinomi quadr¨¤tic (segon grau)Veieu totes les funcions admeses.