8 Voorspellingsfuncties

Alle hier vermelde functies worden ondersteund in:

• Trigger expressies
• Berekende items

De functies worden vermeld zonder aanvullende informatie. Klik op de functie om de volledige details te zien.

Algemene parameters

• /host/key is een algemene verplichte eerste parameter voor de functies verwijzend naar de geschiedenis van het hostitem
• (sec|#num)<:time shift> is een gebruikelijke tweede parameter voor de functies die verwijzen naar de geschiedenis van het hostitem, waarbij:
  • sec - maximum evaluatie periode in seconden (tijd achtervoegsels kan worden gebruikt), of
  • #num - maximum evaluatie bereik in de laatste verzamelde waarden (indien voorafgegaan door een hekje)
  • tijdverschuiving (optioneel) maakt het mogelijk om het evaluatiepunt te verplaatsen terug in de tijd. Bekijk meer details](/manual/config/triggers/expression#time_shift) aan tijdverschuiving aangeven.

Functiedetails

Enkele algemene opmerkingen over functieparameters:

• Functieparameters zijn gescheiden door een komma
• Optionele functieparameters (of parameterdelen) worden aangegeven met < >
• Functie-specifieke parameters worden bij elke functie beschreven
• De parameters /host/key en (sec|#num)<:tijdsverschuiving> mogen nooit tussen aanhalingstekens worden geplaatst

forecast(/host/key,(sec|#num)<:tijdverschuiving>,tijd,<pasvorm>,<modus>)

De toekomstige waarde, max, min, delta of gemiddelde van het item.
Ondersteunde waarsetypes: Float, Integer.

Parameters:

• Zie algemene parameters;
  
• tijd - de voorspellingshorizon in seconden (tijdsuffixen kunnen worden gebruikt); negatieve waarden worden ondersteund;
  
• pasvorm (optioneel; moet tussen dubbele aanhalingstekens staan) - de functie die wordt gebruikt om historische gegevens te passen. Ondersteunde passingen:
  lineair - lineaire functie (standaard)
  polynomiaalN - polynoom van graad N (1 <= N <= 6)
  exponentieel - exponentiële functie
  logarithmisch - logaritmische functie
  macht - machtsfunctie
  Opmerking dat polynomiaal1 gelijk is aan lineair;
• modus (optioneel; moet tussen dubbele aanhalingstekens staan) - de gevraagde output. Ondersteunde modi:
  waarde - waarde (standaard)
  max - maximum
  min - minimum
  delta - max-min
  gem - gemiddelde
  Opmerking dat waarde de itemwaarde schat op het moment now + tijd; max, min, delta en gem onderzoeken de itemwaarde schatting op het interval tussen now en now + tijd.

Opmerkingen:

• Als de te retourneren waarde groter is dan 1.7976931348623157E+308 of kleiner dan -1.7976931348623157E+308, wordt de retourwaarde respectievelijk bijgesneden tot 1.7976931348623157E+308 of -1.7976931348623157E+308;
• Wordt alleen niet-ondersteund als verkeerd gebruikt in de expressie (verkeerd items type, ongeldige parameters), anders wordt -1 teruggegeven in geval van fouten;
• Zie ook aanvullende informatie over voorspellende trigger functies.

Voorbeelden:

forecast(/host/key,#10,1h) #voorspel de itemwaarde over één uur op basis van de laatste 10 waarden
       forecast(/host/key,1h,30m) #voorspel de itemwaarde over 30 minuten op basis van de laatste uur gegevens
       forecast(/host/key,1h:now-1d,12h) #voorspel de itemwaarde over 12 uur op basis van één uur van één dag geleden
       forecast(/host/key,1h,10m,"exponential") #voorspel de itemwaarde over 10 minuten op basis van de laatste uur gegevens en exponentiële functie
       forecast(/host/key,1h,2h,"polynomial3","max") #voorspel de maximale waarde die het item kan bereiken in de komende twee uur op basis van laatste uur gegevens en kubische (derdegraads) polynoom
       forecast(/host/key,#2,-20m) #schat de itemwaarde van 20 minuten geleden op basis van de laatste twee waarden (dit kan nauwkeuriger zijn dan last() gebruiken, vooral als het item zelden wordt bijgewerkt, bijvoorbeeld eens per uur)

timeleft(/host/key,(sec|#num)<:tijdverschuiving>,drempel,<pasvorm>)

De tijd in seconden die nodig is voor een item om de opgegeven drempel te bereiken.
Ondersteunde waarsetypes: Float, Integer.

Parameters:

• Zie algemene parameters;
  
• drempel - de waarde om te bereiken (eenheidssuffixen kunnen worden gebruikt);
• pasvorm (optioneel; moet tussen dubbele aanhalingstekens staan) - zie forecast().

Opmerkingen:

• Als de te retourneren waarde groter is dan 1.7976931348623157E+308, wordt de retourwaarde bijgesneden tot 1.7976931348623157E+308;
• Geeft 1.7976931348623157E+308 terug als de drempel niet kan worden bereikt;
• Wordt alleen niet-ondersteund als verkeerd gebruikt in de expressie (verkeerd items type, ongeldige parameters), anders wordt -1 teruggegeven in geval van fouten;
• Zie ook aanvullende informatie over voorspellende trigger functies.

Voorbeelden:

timeleft(/host/key,#10,0) #de tijd tot de itemwaarde nul bereikt op basis van de laatste 10 waarden
       timeleft(/host/key,1h,100) #de tijd tot de itemwaarde 100 bereikt op basis van de laatste uur gegevens
       timeleft(/host/key,1h:now-1d,100) #de tijd tot de itemwaarde 100 bereikt op basis van één uur van één dag geleden
       timeleft(/host/key,1h,200,"polynomial2") #de tijd tot de itemwaarde 200 bereikt op basis van de laatste uur gegevens en veronderstelling dat het item zich gedraagt als een kwadratische (tweedegraads) polynoom

Zie alle ondersteunde functies.