Hodnoty z archívu - funkcia D2_CalcStatFuncArr

Funkcia umožňuje výpočet archívnej štatistickej funkcie pre všetky dané časové intervaly.

Deklarácia

D2_CalcStatFuncArr

(archObjName, bt, et, step, deepTime, statFuncID, validPerc, paramIdent, bDirectionByRow, refresh)

Parametre

archObjName	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.
step	typ INT	Časový krok [s] v rámci archívneho bloku.
deepTime	typ INT	Časová hĺbka [s] pre výpočet štatistiky. Poznámka: Hodnota parametra musí byť kladné číslo.
statFuncID	typ INT	Typ štatistickej funkcie. Typ je vyjadrený číselnou hodnotou (pozri tabuľku).
validPerc	typ INT	Validačné kritérium.
paramIdentt	typ REAL alebo INT	Parameter pre niektoré typy funkcií.
bDirectionByRoww	typ BOOL	Časové usporiadanie buniek v matici.
refreshh		Nepovinný parameter ľubovoľného typu.

Popis

Návratová hodnota funkcie je typu pole hodnôt. Táto vlastnosť je predurčuje pre použitie v tzv. Matici.

Funkcia vykoná výpočet štatistickej funkcie danej parametrom statFuncID na archívnych dátach reprezentovaných archívnym objektom archObjName pre nasledujúce časové intervaly dané parametrami bt, et, step a deepTime:

prvý časový interval - <bt - deepTime; bt>
druhý časový interval - <bt + step - deepTime; bt + step>
.....
n-tý časový interval - <bt + (N-1)*step - deepTime; bt + (N-1)*step>

Výsledné hodnoty vráti formou poľa, kde jednotlivé hodnoty predstavujú výsledky výpočtu štatistickej funkcie pre jednotlivé časové intervaly.

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 nasledujúcej 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

Pre ostatné štatistické funkcie sa parameter paramIdent nevyhodnocuje.