Funkcia %Aggregate

Popis

Funkcia vypočíta zvolený typ agregácie nad zdrojovým vektorom s danou periodicitou. Voliteľne je možné zadať masku vstupných dát.

Deklarácia
VECTOR %Aggregate(
	VECTOR			_source,
	INT				_aggrType,
	TIME			_bt,
	TIME			_et,
	INT|TEXT		_period
	[, [INT|TEXT	_timeZone := %TIME_ZONE]
	[, [INT			_dayOffset := %DAY_OFFSET]
	[, [INT			_firstWeekDay := 0]
	[, [INT			_invalidAction := 0]
	[, [BOOL		_invalidateIncomplete := 0]
	[, [VECTOR		_mask]]]]]]]
)
Parametre
_source

Zdrojový vektor.

_aggrType

Typ agregácie.

_bt

Začiatočný čas intervalu.

_et

Koncový čas intervalu.

_period

Perióda agregačnej funkcie. Je možné použiť jeden z preddefinovaných krokov, kód alebo id užívateľsky alebo lokálne definovanej periódy.

_timeZone

Identifikátor časového pásma. Použiteľné len v kombinácii s preddefinovanými krokmi.

_dayOffset

Časový posun v sekundách. Použiteľný len v kombinácii s preddefinovanými krokmi.

_firstWeekDay

Poradové číslo prvého dňa v týždni (0 - pondelok). Použiteľné len v kombinácii s preddefinovanými krokmi.

_invalidAction

Spracovanie neplatnej hodnoty v zdrojovom vektore: 0 - ignoruje, 1 - intervalu nastaví Weak, 2 – zneplatní interval.

_invalidateIncompleteUčuje, či sa má zneplatniť celý prvý a/alebo posledný interval výstupu, ak na vstupe nie sú dáta v čase požadovanom podľa zadanej periódy alebo ak časy _bt, _et nie sú zarovnané podľa zadanej periódy.
_maskMaska vstupných dát, kde platná nenulová hodnota označuje hodnoty, ktoré majú byť započítané do agregácie a neplatná alebo nulová hodnota označuje hodnoty, ktoré nemajú byť započítané do agregácie.
Príklad
-- načíta zdrojový vektor a vykoná na ňom sumu s krokom výstupného vektora
VECTOR _v;

%LoadVector(Vector.Src, _BT, _ET);
_v := %Aggregate(Vector.Src, %OP_Sum, _BT, _ET, _STEP);

RETURN _v;

Súvisiace stránky:

Preddefinované kroky
Typ agregácie
Užívateľsky definované periódy
%CreatePeriod

Napíšte komentár