Zápočtová úloha z předmětu KIV/ZSWI UŽIVATELSKÁ PŘÍRUČKA 7. dubna 2013 Tým: Praskolesy Fairytale Team Členové: Michal Kacerovský kacerov2@students.zcu.cz David Hrbáček hrbacekd@students.zcu.cz Ondřej Kupilík kupiliko@students.zcu.cz Marek Naggy naggy@students.zcu.cz
EEGOrganizer UŽIVATELSKÁ PŘÍRUČKA verze 1.0 Historie dokumentu Datum Verze Poznámka Autor 20. dubna 2013 1.0 1. verze dokumentu Michal Kacerovský
Obsah 1 Úvod 4 1.1 O aplikaci EEGorganizer............................ 4 1.2 Technické požadavky............................. 4 1.3 První spuštění................................. 4 1.4 Seznámení s prostředím........................... 4 2 Nastavení aplikace 5 3 Karta Organizovat 6 3.1 Postup při zpracování nových měření.................... 6 4 Karta Procházet 7 A Slovníček 9 B Konvence jmen souborů 9
1 Úvod 1.1 O aplikaci EEGorganizer Aplikace EEGorganizer slouží k hromadnému přejmenování souborů měření EEG myši podle daných konvencí a jejich následnému zařazení do předpřipravené adresářové struktury. Program také umožňuje prohlížení takto organizovaných záznamů. Mimo jiné má uživatel k dispozici základní nastavení pro personalizaci aplikace. 1.2 Technické požadavky EEGorganizer vyžaduje ke svému spuštění běhové prostředí JRE 1.7. Pokud jím Váš počítač nedisponuje, nainstalujte jej 1, než se pokusíte aplikaci spustit. JRE 1.7 vyžaduje minimálněprocesorpentium2266mhz,126mb(32bitos)/181mb(64bitos)volného diskového prostoru, 128 MB fyzické paměti 2. 1.3 První spuštění Pokud jste provedli instalaci běhového prostředí správně a žádný jiný program ve Vašem počítači není asociován s JAR soubory, můžete aplikaci spustit standardním dvojklikem. V jiném případě využijte spouštěcího souboru spustit.bat. Poznámka Jestliže používáte operační systém Windows 7 a při manipulaci se záznamy bude potřeba využít disk, na němž se nacházejí systémové složky, aplikaci bude odepřen přístup. Abyste tomuto předešli, musíte aplikaci spustit jako správce v kontextové nabídce souboru spustit.bat vyberte možnost Spustit jako správce. 1.4 Seznámení s prostředím Aplikace používá dvě hlavní karty Organizovat a Procházet. Karta Organizovat slouží k načtení doposud nezpracovaných záznamů, určení jejich atributů pomocí tabulky a následnému procesu přejmenování a zařazení do adresářové struktury. Karta Procházet pak umožňuje takto organizované záznamy znovu zobrazit, filtrovat je podle atributů nebo prohlížet obsahy jejich hlavičkových a marker souborů. Při prvním spuštění věnujte pozornost nastavení aplikace. 1 Instalační balík lze stáhnout na stránkách výrobce. http://www.oracle.com/technetwork/java/javase/downloads/java-se-jre-7-download-432155.html 2 Udáváno výrobcem. Podrobnější informace na http://docs.oracle.com/javase/7/docs/webnotes/install/windows/windows-system-requirements.html 4
2 Nastavení aplikace V nastavení aplikace můžete určit, odkud se budou nezpracované záznamy standardně načítat, kam se budou kopírovat apod. Dialog s těmito volbami (obrázek 1) vyvoláte tlačítkem Nastavení na kartě Organizovat. Následující výčet uvádí stručný popis nabízených možností: Obrázek 1: Dialog nastavení aplikace 1. Implicitní zdroj. adresář definuje, ze které složky se má aplikace při spuštění pokusit načítat nezpracováné záznamy. Může se jednat např. o cestu k flash disku. Tlačítkem Vybrat... vyvoláte dialog pro výběr adresáře. 2. Cílový adresář záznamů určuje cestu ke kořenovému adresáři s přejmenovanými záznamy. V tomto adresáři budou automaticky vytvořeny dvě podsložky rozlišující měření vidomých a nevidomých myší. Tlačítkem Vybrat... vyvoláte dialog pro výběr adresáře. Tuto položku je nutné nastavit pro úspěšný proces přejmenování a kopírování! 3. Stav čítače měření umožňuje manipulovat s čítačem měření. Důrazně však doporučujeme s touto volbou nemanipulovat. Změnou čítače (především na nižší hodnotu než je aktuální) můžete zapříčinit, že dojde k přepsání stávajících záznamů. Pokud hodnotu čítače změníte, aplikace Vás na případné následky upozorní. 4. po dokončení kopírování odstranit originál zaškrtněte tuto volbu, pokud si přejete po dokončení procesu přejmenování a kopírování odstranit původní soubor ze zdrojového adresáře. I když necháte tuto volbu vypnutou, aplikace bude při dalším načítání nezpracovaných záznamů sama detekovat, zda některé záznamy ve zdrojové složce nebyly již dříve zpracovány a pokud ano, vyřadí je z tabulky. 5. Uložit změny zapíše provedené změny do konfiguračního souboru. 5
Při ukládání nastavení Vám aplikace v závislosti na změnách může formou dotazu nabídnout dodatečnou funkcionalitu. Pokud jste změnili hodnotu pole Implicitní zdroj. adresář, budete dotázáni, zda chcete ihned načíst data z nově určené složky. Pokud se tak rozhodnete, mějte na paměti, že položky z nově zvoleného adresáře nahradí záznamy aktuálně načtené v tabulce. Jestliže jste změnili hodnotu čítače a tuto akci posléze potrvdili, program se Vás zeptá, zda ji chcete aplikovat také na položky aktuálně načtené v tabulce. Pokud budete souhlasit, jednotlivá nezpracovaná měření obdrží nové číslo, přičemž číslo měření první položky bude odpovídat nově nastavené hodnotě čítače. 3 Karta Organizovat Prostřednictvím rozhraní této karty (obrázek 2) můžete načítat do tabulky nezpracované záznamy, měnit jejich atributy a nakonec je podle konvencí přejmenovat a zkopírovat do cílového adresáře. Obrázek 2: Rozhraní karty Organizovat 3.1 Postup při zpracování nových měření Pokud nebyly při spuštění aplikace načteny záznamy z Vámi požadované složky, zvolte pomocí tlačítka Vybrat... adresář, v němž mají být vyhledány záznamy (1). Aplikace ihned prohledá zvolenou složku a nalezené, doposud nezpracované záznamy zobrazí v tabulce. Pomocí tlačítek výběru (2) nebo přímo zaškrtávacími poli u jednotlivých měření (4) vyberte záznamy, jež chcete zpracovat. 6
Položky, které byly načteny s chybovým stavem (6), není možné označit ke zpracování, protože by neskončilo úspěšně. Zobrazeny jsou jen z toho důvodu, že se jedná o záznamy měření, avšak poškozené či nekompletní. U označených záznamů upravte jejich atributy. Dvojklikem nebo stiskem klávesy F2 u vybraných buněk tabulky (5) přepnete do módu editace. Klávesou Enter nebo kliknutím mimo oblast editované buňky pak úpravy ukončíte. Sloupec frekvence lze editovat jen tehdy, když se jedná o měření typu SSVEP. Ve chvíli, kdy dokončíte úpravy vlastností měření, můžete zahájit proces přejmenování a kopírování stiskem Spustit(3). Během něj mohou nastat následující problémy: nepodařilo se vytvořit odkazy mezi soubory Každé měření se skládá z trojice souborů EEG, VHDR a VMRK, přičemž soubory VHDR a VMRK obsahují referenci na zbylé prvky této trojice. Pokud se nepodaří tyto odkazy zachovat, mohlo by být měření některými aplikacemi (včetně EEGorganizeru) vyhodnoceno jako neplatné. K chybě došlo zřejmě kvůli nedostatečným přístupovým právům. nepodařilo se přejmenovat soubory Pravděpodobně došlo k chybě ve chvíli, kdy se aplikace pokoušela změnit jména souborů. K této akci dochází ještě ve zdrojové složce a vyžaduje určitá přístupová práva, jež nejsou např. pro externí disk či disk se systémovými soubory v určitých případech standardně neposkytnuta (viz kapitola 1.3). nepodařilo se zkopírovat soubory Zřejmě došlo k obdobné chybě jako ve výše zmíněném bodu s tím rozdílem, že aplikace nezískala přístupová práva k cílovému adresáři. O těchto případných potížích budete informováni dialogem nebo změnou hodnoty ve sloupci stav. Pokud byl proces úspěšně dokončen, změní se stav zpracovávaných položek na dokončeno. Soubory nyní nesou nový název stanovený dle konvencí (viz dodatek B). Všechny zpracované položky nyní není možné označit ani editovat. Pokud chcete zpracovat další adresář se záznamy, opakujte postup. 4 Karta Procházet Karta Procházet (obrázek 3, str. 8) umožňuje zobrazit veškerá zpracovaná měření a filtrovat je podle jejich vlastností. Obsah tabulky prohlížeče načte aplikace automaticky ihned po jejím spuštění (pokud nastavení definuje cestu k cílovému adresáři, viz kapitola 2). 7
Obrázek 3: Rozhraní karty Procházet 1. ovládací prvky filtru Aby bylo procházení záznamů měření pohodlnější, nabízí aplikace sadu prvků pro filtraci. Při změně hodnoty některého pole se ihned řádky tabulky profiltrují a zobrazí se pouze požadované záznamy. Pokud chcete filtr zrušit, můžete tak snadno učinit stiskem Zobrazit vše. 2. Otevřít adresář měření Zobrazí obsah cílové složky ve výchozí aplikaci pro procházení systému souborů. 3. VHDR soubor a VMRK soubor Karty, které poskytují náhled těchto dvou souborů. 4. tabulka záznamů měření Podobně jako tabulka nezpracovaných záznamů zobrazuje vlastnosti měření, jen je nedovoluje editovat. 8
A Slovníček EEG popř. elektroencefalogram je záznam změny elektrického potenciálu způsobeného mozkovou aktivitou za časovou jednotku. VMRK soubor soubor s popisem konců a začátků stimulů v naměřených datech. VHDR soubor hlavičkový soubor popisující naměřená data. EEG soubor soubor obsahující vlastní naměřená data. JRE (Java Runtime Envinronment) běhové prostředí pro aplikace vytvořené v jazyce Java. B Konvence jmen souborů m{barva}{cislo_mysi}-{typ_mereni}{cislo_mereni}[-f{frekvence}] barva barva měřené myši G (šedá), W (bílá) cislo mysi trojciferné číslo měřené myši typ mereni typ měření S (SSVEP), V (VEP), K (klidové) cislo mereni trojciferné číslo měření frekvence pouze u měření typu S (SSVEP) hodnota v Hz 9