Prognozēšanas funkcijas

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

• Trigeru izteiksmēs
• Aprēķināto vienumu formulās
• Izteiksmju makrosos

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

Kopējie 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 izvērtēšanas periods sekundēs (var izmantot laika piedēkļus), vai
  • #num - maksimālais izvērtēšanas diapazons pēdējās savāktajās vērtībās (ja priekšā ir hash zīme)
  • time shift (neobligāts) ļauj pārvietot izvērtēšanas punktu atpakaļ laikā. Skatiet papildu 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, maksimālā, minimālā, delta vai vidējā vērtība.
Atbalstītie vērtību tipi: Float, Integer.

Parametri:

• Skatiet kopīgos parametrus;
  
• time - prognozēšanas periods sekundēs (piemēram, 1, 60) (var izmantot laika sufiksus (piemēram, 30s, 1m)); tiek atbalstītas negatīvas vērtības;
  
• fit (neobligāts; jāiekļauj dubultpēdiņās) - funkcija, ko izmanto vēsturisko datu pielāgošanai. Atbalstītās 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 funkcijai linear;
• mode (neobligāts; jāiekļauj dubultpēdiņās) - pieprasītais rezultāts. 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 aprēķina vienuma vērtību brīdī now + time; max, min, delta un avg pārbauda vienuma aprēķināto vērtību intervālā no now līdz now + time.

Komentāri:

• Ja atgriežamā vērtība ir lielāka par 1.7976931348623158E+308 vai mazāka par -1.7976931348623158E+308, atgriežamā vērtība tiek ierobežota attiecīgi līdz 1.7976931348623158E+308 vai -1.7976931348623158E+308;
• Kļūst neatbalstīts tikai tad, ja izteiksmē tiek izmantots nepareizi (nepareizs vienuma tips, nederīgi parametri); pretējā gadījumā kļūdu gadījumā atgriež -1;
• Papildinformāciju skatiet sadaļā par prognozējošā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, kas iegūti 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ālo 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 kubisko (trešās pakāpes) polinomu
forecast(/host/key,#2,-20m) #aprēķina 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ā last() izmantošana, ī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.