Metoda může vracet i spočítanou hodnotu nebo pole vypočtených hodnot z hodnot veličin vyhovujících zadanému filtru, viz zadání parametru sWhat.
arr = oTrend.GetData(sWhat, vFilter)
sWhat | (String) Specifikace co se má vrátit: - "a1;" nebo "a1;a2;a3;" - Pokud se má vrátit pole veličin ze záložky Data. Je nutno zachovat pořadí dle pořadí v záložce. Například pokud je pořadí veličin v záložce a1,a2,a3,..., pak v parametru lze zadat například "a1;a3;", ale "a3;a1" je chybně. - "time;" - Pokud se má vrátit pole časů. Volbu času lze pozměnit zadáním "time:winter;", a tehdy se vrátí všechny hodnoty času jako "zimní čas", jinak jako "lokální čas". - "attr;" - Pokud se má vrátit pole atributů věty. - "*data;" - Znamená všechny veličiny mimo času a atributu ("time;*data;" vrací čas a všechny datové veličiny). - "*;" - Vrací čas, atribut a všechny datové veličiny. - "avg(xx)" - Metoda vrací průměrnou hodnotu veličiny xx z hodnot splňujících filtrační podmínky dané filtrem vFilter. - "avg(xx;weighted)" - Metoda vrací váženou průměrnou hodnotu veličiny xx z hodnot splňujících filtrační podmínky dané filtrem vFilter. Váhou hodnoty je zde délka jejího trvání do doby uložení následující hodnoty. - "min(xx)" - Metoda vrací minimální hodnotu veličiny xx z hodnot splňujících filtrační podmínky dané filtrem vFilter. - "max(xx)" - Metoda vrací maximální hodnotu veličiny xx z hodnot splňujících filtrační podmínky dané filtrem vFilter. - "sum(xx)" - Metoda vrací součet všech hodnot veličiny xx z hodnot splňujících filtrační podmínky dané filtrem vFilter. - "count(xx)" - Metoda vrací počet hodnot veličiny xx z hodnot splňujících filtrační podmínky dané filtrem vFilter. |
---|---|
vFilter | (Variant) Hodnota určující například časový rozsah získávaných dat (čas od, čas do, počet bodů, atd.), případně zda data mají být filtrována dle hodnoty. Je vytvořen voláním metod CreateFilter, AddFilter. Pokud v parametru sWhat je seznam veličin, pak by nastal případ že pro každou veličinu by byl jiný počet řádku (jiný počet uložených hodnot). Provede se proto "průnik řádků" - tzn. vrátí se pouze řádky, které jsou společné všem veličinám. Pokud v parametru sWhat je funkce pro výpočet, pak se hodnotové filtry pro jednotlivé veličiny budou aplikovat pouze na výpočet těchto veličin a nebudou ovlivňovat výpočet jiných veličin. |
Pokud v sWhat je funkce pro výpočet, pak se vrací buď jednoduchá hodnota nebo 1-rozměrné pole spočítaných hodnot.