Dokumentacja SVAROG: Różnice pomiędzy wersjami

Z Brain-wiki
(Utworzono nową stronę "==Compiling and running Svarog== How to download and compile Svarog on your computer. What to expect during the first run. ==S...")
 
(UWAGA! Zastąpienie treści hasła bardzo krótkim tekstem: „==Compiling and running Svarog== How to download and compile Svarog on your computer. Wh...”)
 
(Nie pokazano 1 pośredniej wersji utworzonej przez tego samego użytkownika)
Linia 1: Linia 1:
 
==[[Svarog/Users Manual/Compiling_Svarog|Compiling and running Svarog]]==
 
==[[Svarog/Users Manual/Compiling_Svarog|Compiling and running Svarog]]==
 
How to download and compile Svarog on your computer. What to expect during the first run.
 
How to download and compile Svarog on your computer. What to expect during the first run.
==[[Svarog/Users Manual/Loading signal|Loading signals]]==
 
How to load signal:
 
*[[Svarog/Users_Manual/Loading_signal/From file|from file]],
 
*[[Svarog/Users_Manual/Loading_signal/Online|streamed from a port]],
 
*[[Svarog/Users_Manual/Loading_signal/Online|from an amplifier]].
 
==[[Svarog/Users Manual/Viewing books|Viewing books]]==
 
How to open and browse books (representations of signals obtained by [http://en.wikipedia.org/wiki/Matching_pursuit MP decomposition]).
 
 
==[[Svarog/Users Manual/Recording|Recording signals]]==
 
How to record signals using Svarog.
 
==[[Svarog/Users_Manual/Loading_signal/Montages|Montage]]==
 
How to change, choose and save signal montages.
 
==[[Svarog/Users_Manual/Loading_signal/Filtering|Filtering]]==
 
How to filter the signal.
 
==[[Svarog/Users Manual/Tagging signal|Tagging signals]]==
 
How to tag an offline signal.
 
 
==[[Svarog/Users Manual/FFT|Online/Offline FFT tool]]==
 
How to check the frequency content using FFT.
 
<!--==[[Svarog/Users Manual/Plugins|Plugins]]==
 
How to check frequency content of a part of a signal.-->
 
==[[Svarog/Users Manual/MP Decomposition|Signal decomposition using Matching Pursuit]]==
 
How to decompose the signal using the Matching Pursuit algorithm
 
==[[Svarog/Users Manual/Average Evoked Potentials|Average Evoked Potentials]]==
 
How to compute Average Evoked Potentials using Svarog.
 
==[[Svarog/Users Manual/Stager|Automatic sleep staging]]==
 
How to automatically stage sleeps EEG, obtaining a polysomnogram.
 
==[[Svarog/Users Manual/Artifact|Automatic artifact detection]]==
 
How to perform automatic EEG artifact detection using Svarog.
 
==[[Svarog/Users Manual/Presets|Preset interface in Svarog]]==
 
Saving configuration and settings in Svarog.
 
==[[Svarog/Users Manual/Export to EEGLab|Export to EEGLab]]==
 
Svarog allows to export the currently opened signal to EEGLab.
 
 
==How to==
 
#[[Svarog/Users Manual/Change electrode names|Change electrode names]].
 
#[[Svarog/Users Manual/Check signal|Check quality of the signal received online]].
 
[[Category:Svarog - User manual]]
 
#[[Svarog/Users Manual/Add cap type|Add EEG cap type]]
 
<!--Mostly self-explanatory, yet contributions of users are surely welcome! :-)
 
 
=== Filters-design-window attributes (in Polish by now) ===
 
no więc, jak jest filtr, to on ma passband (pasmo częstotliwości, które
 
przepuszcza) i stopband (pasmo częstotliwości, które filtr tłumi).
 
W przypadku filtru dolno/górnoprzepustowego jest po jednym takim paśmie,
 
w przypadku pasmowoprzepustowego jest jedno pasmo przepustowe i dwa
 
zaporowe, w przypadku zaporowego jest jedno pasmo zaporowe, dwa
 
przepustowe.
 
 
Stopband attenuation [dB] - jak bardzo mają być tłumione wszystkie
 
częstotliwości z pasma zaporowego (np. 40 dB)
 
 
passband ripple [dB] - jakie mogą być wahania tłumienia w paśmie
 
przepustowym (idealnie by było, gdyby pasmo przepustowe nie było nigdy
 
wcale tłumione, no ale filtrom jest 'łatwiej', żeby były jakieś wahania
 
w tym, że w niektórych częstotliwościach sobie trochę potłumią, tak ze 3
 
dB).
 
 
pomiedzy pasmem zaporowym a przepustowym jest zawsze pasmo przepustowe -
 
czestotliwosci należące do niego nie są ani tak stłumione, jak chcemy
 
ustawiając stopband attenuation, ani nie są tak dobrze przepusczzane jak
 
chce passband ripple.
 
 
passband edge frequencies - skrajne częstotliwości z pasma przepustowego
 
(z jednej strony stykaja sie z pasmem przepustowym, a z drugiej z pasmem
 
przejsciowym)
 
stopband edge frequencies - skrajne częstotliwości z pasma zaporowego (z
 
jednej strony stykają się z pasmem zaporowym, a z drugiej z pasmem
 
przejściowym).
 
 
odległość pomiędzy passband edge frequency a stopband edge frequency to
 
pasmo przejsciowe - im większe, tym niższy rząd filtra. 0.5 Hz to trochę
 
za mało, butterworth sobie nie poradzi, ellip może już bardziej.
 
 
aha - zawsze trzeba sobie sprawdzić, czy projektant poradził sobie z
 
parametrami - przy zbyt restrykcyjnych parametrach - wąskie pasmo
 
(pasma) przejściowe, wysokie tłumienie w paśmie zaporowym (stopband
 
attenuation), niskie tłumienie w paśmie - on może bez ostrzeżenia
 
zaprojektować filtr, który nie zadziała - widać to wtedy na wykresie,
 
który wygląda słabo, dlatego trzeba sobie sprawdzać wykresy do
 
filtrów.
 
 
=== How to add in-built standard filters to standar-filters-list (in Polish by now) ===
 
jest taki plik AbstractSignalTypeConfigurer.java i tam są pododawane.
 
 
np.
 
 
filters.add(new TimeDomainSampleFilter(FilterType.LOWPASS, ApproximationFunctionType.BUTTERWORTH, new double[] {20, 0}, new double[] {30, 0}, 5.0, 20.0));
 
 
 
 
 
 
parametry to:
 
 
-typ filtra
 
 
- rodzina
 
 
- tablica częstotliwości granicznych pasma przepustowego
 
 
- tablica częstotliwości granicznych pasma zaporowego
 
 
- wahania w paśmie przepustowym
 
 
- wymagane tłumienie w paśmie zaporowym
 
 
 
 
jak robisz lowpassa/highpassa to z w tych tablicach ważny jest tylko pierwszy element, ale drugi też wpisz (np. 0).
 
 
 
 
Czasem się robi błąd - człek robi np lowpassa, a częstotliwość graniczna pasma przepustowego ustawia większą niż częstotliwość graniczna pasma zaporowego (czyli w częstotliwościach jest highpass, a w parametr pierwszy mówi, że to highpass) i analogiczne błedy dla bandpassów itd. W GUI takie coś jest zablokowane, ale w kodzie można to wpisać.
 
[[category:Svarog]]-->
 

Aktualna wersja na dzień 07:25, 27 lip 2015

Compiling and running Svarog

How to download and compile Svarog on your computer. What to expect during the first run.