Uživatelský manuál Aplikace GraphViewer Vytvořil: Viktor Dlouhý
Obsah 1. Obecně... 3 2. Co aplikace umí... 3 3. Struktura aplikace... 4 4. Mobilní verze aplikace... 5 5. Vytvoření projektu... 6 6. Části aplikace... 9 6.1. Souborový správce... 9 6.2. Výběr dat... 10 6.3. Prohlížeč grafu... 11 6.4. Editor dat... 12 2/12
1. Obecně Aplikace GraphViewer může být nainstalována na tablety s operačním systémem Android verze 3.2 a vyšší nebo na mobilní telefony s verzí 4.0 a vyšší. GraphViewer využívá k některým svým funkcím přístup k internetu a k externímu datovému úložišti. Aplikace je otestována na zařízeních HTC Desire Z a Acer Iconia A500. Při používání aplikace na malých displejích je podporován pouze portrét mód (na výšku), na zařízeních s velkým displejem je podporována rotace displeje na výšku i na šířku. 2. Co aplikace umí Obrázek 1 - snímek obrazovky načítat všechny typy CSV souboru pokročilé načítání - možnost ořezu a vzorkování průzkumník úložiště komunikace s Teco PLC pomocí HTTP stahovat CSV soubory z Teco PLC možnost mít otevřených více projektů zároveň ukládat projekty do XML souborů zobrazovat data v grafech fullscreen mód při zobrazování grafu editovat data zoomovat grafy provádět časově náročné aplikace na pozadí aplikace ukládat stav aplikace při systémovém přepínání programů optimalizovaný vzhled pro menší displeje 3/12
3. Struktura aplikace Aplikace se dělí do dvou částí, mezi nimi je možné přepínat záložkami Úložiště a Prohlížeč. Záložky jsou umístěny v akčním panelu, který ještě obsahuje jméno a ikonku aplikace, a především kontextovou nabídku v podobě akčních tlačítek a menu. Obrázek 2 akční panel Záložka Úložiště obsahuje prohlížeč souborů a nástroje pro vytvoření projektu. Z tohoto místa je také možné otevírat projekty. Úložiště o Projekty prohlížeč již vytvořených projektů, projekty se ukládají do speciální nepřístupné paměti o SD Karta prohlížeč paměťové karty pro vyhledávání CSV souborů Nový projekt o Z prázdného souboru vytvoří nový projekt, jenž nebude obsahovat žádná data o Z CSV souboru vytvoří projekt z existujícího souboru umístěného na paměťové kartě o Ze souboru Teco HTTP vytvoří nový projekt ze souboru nacházejícího se v úložišti PLC Tecomat o Z Teco Epsnet příprava na implementaci protokolu Epsnet zatím bez funkce Záložka Prohlížeč obsahuje uživatelem otevřené projekty, mezi kterými lze libovolně přepínat pomocí panelu otevřených projektů. Zároveň se v levé části obrazovky nachází výběrové menu, které zpřístupňuje hlavní funkce pro prohlížeč grafů. Obrázek 3 levé výběrové menu Obrázek 4 panel otevřených projektů Výběr dat pomocí této funkce je možné vybrat sloupce dat, které je třeba zobrazit Graf vykresluje graf aktivních sloupců Editor dat funkce umožňuje editovat jednotlivé položky dat 4/12
4. Mobilní verze aplikace Aplikace GraphViewer vypadá na menším displeji trochu jinak, struktura je však zachována. Části obrazovky, které se na verzi pro tablet zobrazují najednou, jsou na mobilním telefonu rozděleny. Přechod mezi nimi je plynulý a intuitivní. Pro návrat o úroveň zpět slouží tlačítko operačního systému Zpět. Akční panel je možné nalézt v dolní části displeje, tam jsou zobrazena akční tlačítka. Další možnosti jsou zobrazeny po stisku tlačítka operačního systému Menu. Obrázek 5 - rozložení mobilní verze aplikace 5/12
5. Vytvoření projektu Projekt je nutný pro práci s aplikací a nese v sobě všechna potřebná data grafu. Bez projektu nelze s aplikací pracovat. Pro vytvoření projektu se nabízí hned několik možnosti, je možné ho vytvořit následovně: Z prázdného souboru projekt neobsahuje žádné datové sloupce, ty je třeba přidat v Editoru dat, až poté je možné zobrazit graf Z CSV souboru CSV slouží jako hlavní podkladový soubor pro projekt, je možné z něj vytvořit projekt, který nese datovou strukturu jako původní CSV Z Teco HTTP souboru PLC Tecomat Foxtrot umožňují logování do souboru, pomocí tohoto způsobu vytvoření projektu je možné tento soubor získat přes HTTP a následně s ním plnohodnotně pracovat Ukázka vytvoření projektu z CSV souboru Předpokládejme, že jsme si z internetu stáhli soubor formátu CSV a potřebujeme jeho data zobrazit v grafu. Tento soubor se jmenuje products.csv, použijeme zabudovaný správce souborů a pomocí něj (Uložiště -> SD karta -> ) najdeme vhodný soubor. Soubory stažené prohlížečem webových stránek se obvykle ukládají do adresáře Download Obrázek 6 soubor typu CSV 6/12
Když na něj klikneme, zobrazí se formulář s několika kolonkami, automaticky se vyplní název a cesta k CSV souboru. Pokročilejší uživatel by si mohl všimnout netradiční cesty souboru, která obsahuje slovo external. Tímto způsobem aplikace zjednodušuje informaci o cestě. V zásadě mohou nastat jen dva případy a to external označuje externí úložiště, a internal - označuje úložiště pro projekty. Pro zpracování souboru klikneme na tlačítko Nahrát, program použije speciálně vytvořený postup a pokusí se najít vhodný oddělovač použitý v CSV souboru, zároveň načte velikost souboru. Ve chvíli, kdy je vše načteno, objeví se několik dalších formulářových elementů, které umožňují upravovat strukturu dat. Především je dovoleno ořezat řádky v souboru a použít vzorkování. Pro příklad se rozhodneme použít jen 17. až 65. řádek souboru, víme, že první řádek je označen nulou a soubor obsahuje 77 řádků dat. Zároveň použijeme i vzorkování a to tím způsobem, že z datového souboru chceme vzít pouze každý 3. řádek. Vzorkování se hodí především u velkých souborů, práce s nimi je totiž časově náročná. Platí, že čím je méně dat, tím je práce rychlejší. Obrázek 7 vytvoření projektu 7/12
Když jsme spokojeni s nastavením dat projektu, zbývá již jen vytvoření samotného projektu. Tato operace může chvíli trvat, u velkých souborů to může být i několik minut. Pokud se zpracovává velký soubor, je možné kliknout v dialogu na tlačítko Na pozadí, které zavře dialog a je možné dále pracovat s aplikací. Když je projekt vytvořen zobrazí se informační hláška. Obrázek 8 informace o vytvoření projektu Vytvořené projekty se vždy umisťují do speciální složky vnitřního úložiště. To zaručuje přehlednost a jednoduchost ve správě projektů. Námi vytvořený soubor se jmenuje products.xml. Tímto způsobem jsme tedy jednoduše vytvořili projekt z CSV souboru. Pouhým kliknutím jej lze otevřít a pracovat s ním v Prohlížeči. Obrázek 9 - projekty 8/12
6. Části aplikace 6.1. Souborový správce Souborový správce je použit ve dvou částech aplikace, ve správci projektů a zároveň v prohlížeči SD karty. Souborový správce umožňuje prohlížet libovolnou úroveň souborového systému. Každý soubor podle zvyklosti odpovídá jedné položce v seznamu. Každá položka zobrazuje ikonku souboru, název, typ souboru a velikost. Obrázek 10 Souborový správce pro potřeby aplikace rozlišuje následující typy souborů: Složka klasický adresář, kontejner jiných souborů a složek Projekt soubor formátu XML, jenž obsahuje vytvořený projekt CSV podkladový datový soubor CSV Neznámý jakýkoliv jiný soubor Kvůli možnosti editace je ve správci zároveň zavedena kontextová nabídka v podobě dialogu. Ten se zobrazí po dlouhém stisku položky. Soubor je díky tomu možné smazat či přejmenovat. Obrázek 11 - kontextový dialog 9/12
6.2. Výběr dat Všechny otevřené projekty se zobrazují v Prohlížeči, který je rozdělen do několika částí. Výběr dat umožňuje zobrazit náhledy dat v podobě tabulek. Každý sloupec podkladového CSV souboru odpovídá jedné tabulce, která obsahuje pořadové číslo, jméno a první tři hodnoty sloupce. Pro zvolení sloupce je nutné klinout na tabulku, ta se následně označí. Všechny aktivní sloupce jsou vybarveny modře. Ty sloupce, které jsou aktivní, mohou být následně vykresleny v grafu. Je možné označit jen sloupce, jejichž hodnoty jsou číselného typu. Ve Výběru dat je, stejně jako ve Správci souborů, možné upravovat položky pomocí kontextového dialogu, který se zobrazí po delším stisku položky. Pomocí levého panelu je možné sloupce filtrovat. Obrázek 12 - výběr dat 10/12
6.3. Prohlížeč grafu Prohlížeč grafu je jeden z nejdůležitějších funkcí celé aplikace. Zobrazuje datové sloupce, které jsou v tu chvíli aktivní. Prohlížeč automaticky vybírá rozsah v rámci funkční hodnoty podle minima a maxima. Automaticky je též volena barva datové řady. V prohlížeči je možné použít několik gest: přibližování oddalování režim na celou obrazovku zobrazování funkčních hodnot Obrázek 14 - přibližování Obrázek 13 - oddalování Obrázek 16 - režim na celou obrazovku Obrázek 15 - zobrazování funkčních hodnot 11/12
6.4. Editor dat Editor dat je část aplikace, která umožňuje editovat jednotlivé hodnoty ve sloupcích. Editace spravuje jeden datový soubor stejně jako ostatní části Prohlížeče, aktualizace ostatních částí probíhá automaticky, není proto problém upravit nějakou hodnotu a hned si ji nechat zobrazit v grafu. Editor dat umožňuje měnit jakékoliv hodnoty, textové i číselné. Obrázek 17 - Editor dat 12/12