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


Napíšte komentár