Hodnoty z archívu - funkcia D2_CalcStatFunc

Funkcia umožňuje výpočet archívnej štatistickej funkcie na požiadanie.

Deklarácia

D2_CalcStatFunc

(archIdent, bt, et, statFuncID, validPerc, paramIdent, refresh)

Parametre

archIdent	typ TEXT	Odkaz na jednu archívnu hodnotu. Odkaz na jednoduchú hodnotu objektu. V prípade štruktúrovanej premennej je to jedno políčko (SV.Struct[2]^Item), ináč je to meno objektu (napríklad meraný bod). V tomto prípade systém automaticky zabezpečí vyhľadanie "vhodného" archívneho objektu. Ak je stĺpec "Item" typu objekt, je možné zadať bezprostredne za menom stĺpca reťazec ",ALL" (napríklad SV.Struct[4]^Item,ALL). Vtedy sú získavané archívne hodnoty pre objekt, na ktorý ukazuje príslušné políčko, nie pre políčko ako také.
bt	typ ABS. ČAS	Počiatočný čas intervalu.
et	typ ABS. ČAS	Koncový čas intervalu.
statFuncID	typ INT	Typ štatistickej funkcie. Typ je vyjadrený číselnou hodnotou (pozri tabuľku).
validPerc	typ INT	Validačné kritérium.
paramIdent	typ REAL alebo INT	Parameter pre niektoré typy funkcií.
refresh		Nepovinný parameter ľubovoľného typu.

Popis

Funkcia vykoná výpočet štatistickej funkcie danej parametrom statFuncID na archívnych dátach reprezentovaných archívnym objektom archIdent pre časový interval daný parametrami bt a et. Po úspešnom vykonaní výpočtu funkcia vráti výslednú hodnotu.

Parameter validPerctIdent_Int predstavuje Validačné kritérium použité pri vyhodnocovaní štatistickej funkcie. Môže nadobúdať hodnoty 0 .. 100 (chyba pri nedodržaní podmienky ERR_RANGE_ERROR).

Pre niektoré štatistické funkcie je potrebné zadať parameter paramIdent podľa nasledovnej tabuľky:

Štatistická funkcia

Popis parametra

_STAT_F_INTEGRAL

Časový rozmer vstupu. Pre jednotlivé typy sú taktiež zavedené preddefinované lokálne konštanty podľa tabuľky:

Konštanta	Popis
_INTEGRAL_HOURUNIT	Hodinový integrál
_INTEGRAL_MINUNIT	Minútový integrál
_INTEGRAL_SECUNIT	Sekundový integrál

_STAT_F_GE_TIME
_STAT_F_GT_TIME
_STAT_F_LE_TIME
_STAT_F_LT_TIME
_STAT_F_ADDITION_PARAM
_STAT_F_INCREMENT_PARAM
_STAT_F_DELTA_PARAM

Referenčná hodnota