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.