Documentation
Table of Contents
8 Funkcje predykcyjne
Wszystkie funkcje wymienione tutaj s? obs?ugiwane w:
Kilka og¨®lnych uwag na temat parametr¨®w funkcji:
- Parametry funkcji s? oddzielone przecinkiem
- Opcjonalne parametry funkcji (lub cz??ci parametr¨®w) s? oznaczone jako
<> - Specyficzne dla funkcji parametry s? opisane przy ka?dej funkcji
- Parametry
/host/keyoraz(sec|#num)<:time shift>nigdy nie powinny by? umieszczane w cudzys?owiu
Wsp¨®lne parametry
/host/keyto wsp¨®lny obowi?zkowy pierwszy parametr dla funkcji, odnosz?cych si? do historii pozycji hosta(sec|#num)<:time shift>to wsp¨®lny drugi parametr dla funkcji, odnosz?cych si? do historii pozycji hosta, gdzie:- sec - maksymalny okres ewaluacji w sekundach (mo?na u?ywa? przyrostk¨®w czasowych), lub
- #num - maksymalny zakres ewaluacji w ostatnio zbieranych warto?ciach (je?li poprzedzony jest znakiem hash)
- time shift (opcjonalny) pozwala przesun?? punkt ewaluacji wstecz w czasie. Zobacz wi?cej szczeg¨®?¨®w na temat okre?lania przesuni?cia czasowego.
Funkcje predykcyjne
| FUNKCJA | ||
|---|---|---|
| Opis | Parametry specyficzne dla funkcji | Uwagi |
| forecast (/host/key,(sec|#num)<:time shift>,time,<fit>,<mode>) | ||
| Przysz?a warto??, maksimum, minimum, r¨®?nica lub ?rednia pozycji. | Zobacz wsp¨®lne parametry. time - horyzont prognozy w sekundach (mog? by? u?ywane przyrostki czasu); obs?ugiwane s? warto?ci ujemne fit (opcjonalny; musi by? w podw¨®jnych cudzys?owach) - funkcja u?ywana do dopasowania danych historycznych Obs?ugiwane parametry fit:linear - funkcja liniowa polynomialN - wielomian stopnia N (1 <= N <= 6) exponential - funkcja wyk?adnicza logarithmic - funkcja logarytmiczna power - funkcja pot?gowa Uwaga: linear jest domy?lna, polynomial1 jest r¨®wnowa?ne linear mode (opcjonalny; musi by? w podw¨®jnych cudzys?owach) - ??dane wyj?cie Obs?ugiwane parametry mode:value - warto?? (domy?lne) max - maksimum min - minimum delta - max-min avg - ?rednia Uwaga: value szacuje warto?? pozycji w momencie teraz + timemax, min, delta i avg badaj? szacunkow? warto?? pozycji w przedziale mi?dzy teraz a teraz + time |
Obs?ugiwane typy warto?ci: float, int Je?li warto?? do zwr¨®cenia jest wi?ksza ni? 1.7976931348623157E+308 lub mniejsza ni? -1.7976931348623157E+308, zwr¨®cona warto?? jest przyci?ta odpowiednio do 1.7976931348623157E+308 lub -1.7976931348623157E+308. Staje si? nieobs?ugiwana tylko w przypadku niew?a?ciwego u?ycia w wyra?eniu (z?y typ pozycji, nieprawid?owe parametry), w przeciwnym razie zwraca -1 w przypadku b??d¨®w. Przyk?ady: => forecast(/host/key,#10,1h) ¡ú prognozuj warto?? pozycji za godzin? na podstawie ostatnich 10 warto?ci => forecast(/host/key,1h,30m) ¡ú prognozuj warto?? pozycji za 30 minut na podstawie danych z ostatniej godziny => forecast(/host/key,1h:now-1d,12h) ¡ú prognozuj warto?? pozycji za 12 godzin na podstawie danych z godziny sprzed jednego dnia => forecast(/host/key,1h,10m,"exponential") ¡ú prognozuj warto?? pozycji za 10 minut na podstawie danych z ostatniej godziny i funkcji wyk?adniczej => forecast(/host/key,1h,2h,"polynomial3","max") ¡ú prognozuj maksymaln? warto??, jak? mo?e osi?gn?? pozycja w ci?gu nast?pnych dw¨®ch godzin na podstawie danych z ostatniej godziny i wielomianu trzeciego stopnia => forecast(/host/key,#2,-20m) ¡ú oszacuj warto?? pozycji sprzed 20 minut na podstawie ostatnich dw¨®ch warto?ci (mo?e to by? bardziej precyzyjne ni? u?ycie last(), szczeg¨®lnie je?li pozycja jest rzadko aktualizowana, np. raz na godzin?) Zobacz tak?e dodatkowe informacje na temat predykcyjnych funkcji wyzwalaczy. |
| timeleft (/host/key,(sec|#num)<:time shift>,threshold,<fit>) | ||
| Czas w sekundach potrzebny do osi?gni?cia przez pozycj? okre?lonego progu. | Zobacz wsp¨®lne parametry. threshold - warto?? do osi?gni?cia (mog? by? u?ywane przyrostki jednostek) fit (opcjonalny; musi by? w podw¨®jnych cudzys?owach) - zobacz forecast() |
Obs?ugiwane typy warto?ci: float, int Je?li warto?? do zwr¨®cenia jest wi?ksza ni? 1.7976931348623157E+308, zwr¨®cona warto?? jest przyci?ta do 1.7976931348623157E+308. Zwraca 1.7976931348623157E+308, je?li pr¨®g nie mo?e by? osi?gni?ty. Staje si? nieobs?ugiwana tylko w przypadku niew?a?ciwego u?ycia w wyra?eniu (z?y typ pozycji, nieprawid?owe parametry), w przeciwnym razie zwraca -1 w przypadku b??d¨®w. Przyk?ady: => timeleft(/host/key,#10,0) ¡ú czas do osi?gni?cia przez warto?? pozycji zera na podstawie ostatnich 10 warto?ci => timeleft(/host/key,1h,100) ¡ú czas do osi?gni?cia przez warto?? pozycji 100 na podstawie danych z ostatniej godziny => timeleft(/host/key,1h:now-1d,100) ¡ú czas do osi?gni?cia przez warto?? pozycji 100 na podstawie danych z godziny sprzed jednego dnia => timeleft(/host/key,1h,200,"polynomial2") ¡ú czas do osi?gni?cia przez warto?? pozycji 200 na podstawie danych z ostatniej godziny i za?o?enia, ?e pozycja zachowuje si? jak wielomian kwadratowy (drugiego stopnia) Zobacz tak?e dodatkowe informacje na temat predykcyjnych funkcji wyzwalaczy. |