8 Prognozējošās funkcijas

Visas šeit uzskaitītās funkcijas tiek atbalstītas:

• Trigeru izteiksmēs
• Aprēķinātajos vienumos
• Izteiksmju makrosos

Funkcijas ir uzskaitītas bez papildu informācijas. Noklikšķiniet uz funkcijas, lai skatītu pilnu informāciju.

Kopīgie parametri

• /host/key ir kopīgs obligāts pirmais parametrs funkcijām, kas atsaucas uz hosta vienuma vēsturi
• (sec|#num)<:time shift> ir kopīgs otrais parametrs funkcijām, kas atsaucas uz hosta vienuma vēsturi, kur:
  • sec - maksimālais novērtēšanas periods sekundēs (var izmantot laika sufiksus), vai
  • #num - maksimālais novērtēšanas diapazons pēdējās savāktajās vērtībās (ja pirms tā ir restīte)
  • time shift (neobligāts) ļauj pārvietot novērtēšanas punktu atpakaļ laikā. Skatiet sīkāku informāciju par time shift norādīšanu.

Funkciju informācija

Dažas vispārīgas piezīmes par funkciju parametriem:

• Funkciju parametrus atdala ar komatu
• Neobligātie funkciju parametri (vai parametru daļas) tiek norādīti ar < >
• Katras funkcijas specifiskie parametri ir aprakstīti pie attiecīgās funkcijas
• Parametri /host/key un (sec|#num)<:time shift> nekad nedrīkst būt pēdiņās

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

Vienuma nākotnes vērtība, maksimums, minimums, delta vai vidējā vērtība.
Atbalstītie vērtību tipi: Float, Integer.

Parametri:

• Skatiet kopīgos parametrus;
  
• time - prognozēšanas horizonts sekundēs (var izmantot laika sufiksus); tiek atbalstītas arī negatīvas vērtības;
  
• fit (neobligāts; jāliek dubultpēdiņās) - funkcija, ko izmanto vēsturisko datu pielāgošanai. Atbalstītās pielāgošanas funkcijas:
  linear - lineāra funkcija (noklusējums)
  polynomialN - N pakāpes polinoms (1 <= N <= 6)
  exponential - eksponenciāla funkcija
  logarithmic - logaritmiska funkcija
  power - pakāpes funkcija
  Ņemiet vērā, ka polynomial1 ir ekvivalents linear;
• mode (neobligāts; jāliek dubultpēdiņās) - pieprasītā izvade. Atbalstītie režīmi:
  value - vērtība (noklusējums)
  max - maksimums
  min - minimums
  delta - max-min
  avg - vidējā vērtība
  Ņemiet vērā, ka value novērtē vienuma vērtību brīdī now + time; max, min, delta un avg analizē vienuma vērtības novērtējumu intervālā starp now un now + time.

Komentāri:

• Ja atgriežamā vērtība ir lielāka par 1.7976931348623158E+308 vai mazāka par -1.7976931348623158E+308, atgrieztā vērtība tiek attiecīgi ierobežota līdz 1.7976931348623158E+308 vai -1.7976931348623158E+308;
• Kļūst neatbalstīts tikai nepareizas izmantošanas gadījumā izteiksmē (nepareizs vienuma tips, nederīgi parametri), pretējā gadījumā kļūdu gadījumā atgriež -1;
• Skatiet arī papildu informāciju par prognozējošajām trigeru funkcijām.

Piemēri:

forecast(/host/key,#10,1h) #prognozē vienuma vērtību pēc vienas stundas, pamatojoties uz pēdējām 10 vērtībām
forecast(/host/key,1h,30m) #prognozē vienuma vērtību pēc 30 minūtēm, pamatojoties uz pēdējās stundas datiem
forecast(/host/key,1h:now-1d,12h) #prognozē vienuma vērtību pēc 12 stundām, pamatojoties uz vienas stundas datiem pirms vienas dienas
forecast(/host/key,1h,10m,"exponential") #prognozē vienuma vērtību pēc 10 minūtēm, pamatojoties uz pēdējās stundas datiem un eksponenciālu funkciju
forecast(/host/key,1h,2h,"polynomial3","max") #prognozē maksimālo vērtību, ko vienums var sasniegt nākamo divu stundu laikā, pamatojoties uz pēdējās stundas datiem un kubisku (trešās pakāpes) polinomu
forecast(/host/key,#2,-20m) #novērtē vienuma vērtību pirms 20 minūtēm, pamatojoties uz pēdējām divām vērtībām (tas var būt precīzāk nekā izmantot last(), īpaši, ja vienums tiek atjaunināts reti, piemēram, reizi stundā)

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

Laiks sekundēs, kas nepieciešams, lai vienums sasniegtu norādīto slieksni.
Atbalstītie vērtību tipi: Float, Integer.

Parametri:

• Skatiet kopīgos parametrus;
  
• threshold — sasniedzamā vērtība (var izmantot vienību sufiksus);
• fit (neobligāts; jāliek dubultpēdiņās) — skatiet forecast().

Komentāri:

• Ja atgriežamā vērtība ir lielāka par 1.7976931348623158E+308, atgrieztā vērtība tiek ierobežota līdz 1.7976931348623158E+308;
• Atgriež 1.7976931348623158E+308, ja slieksni nevar sasniegt;
• Kļūst neatbalstīts tikai tad, ja tas tiek nepareizi izmantots izteiksmē (nepareizs vienuma tips, nederīgi parametri), pretējā gadījumā kļūdu gadījumā atgriež -1;
• Skatiet arī papildu informāciju par prognozējošajām trigeru funkcijām.

Piemēri:

timeleft(/host/key,#10,0) #laiks līdz vienuma vērtība sasniedz nulli, pamatojoties uz pēdējām 10 vērtībām
timeleft(/host/key,1h,100) #laiks līdz vienuma vērtība sasniedz 100, pamatojoties uz pēdējās stundas datiem
timeleft(/host/key,1h:now-1d,100) #laiks līdz vienuma vērtība sasniedz 100, pamatojoties uz vienas stundas datiem pirms vienas dienas
timeleft(/host/key,1h,200,"polynomial2") #laiks līdz vienuma vērtība sasniedz 200, pamatojoties uz pēdējās stundas datiem un pieņēmumu, ka vienums uzvedas kā kvadrātisks (otrās pakāpes) polinoms

Skatīt visas atbalstītās funkcijas.