Dokumentacja programu Psychopy

Psychopy-brain

Instrukcja omawia funkcjonalności wprowadzone w bibliotece Psychopy w wersji brain.

A. BCI-Appliance

BCI-Appliance to urządzenie umożliwiające wyświetlanie bodźców wzrokowych z dużą częstością. Urządzenie razem ze sposobem jego uruchamiania zostało opisane w instrukcji użytkownika BCI-Appliance. Biblioteka Psychopy w wersji brain wyposażona jest w oddzielny bloczek do jego obsługi (ilustracja 1).

Ilustracja 1. Bloczek blinker

Po wybraniu bloczka wyświetlone zostaje okno zawierające modyfikowalne atrybuty urządzenia (ilustracja 2).

Ilustracja 2. Okno bloczka blinker

Wśród parametrów znajdują się:

• Stimulating function - [str] funkcja stymulująca: 'rect' - prostokątna i 'sin' - sinus.
• Duty cycle - [float] liczba z zakresu 0-100 określająca stopień wypełnienia.
• Stimulating frequencies - [array of 16 ints] 16-elementowa lista z częstościami stymulacji dla każdego z pól BCI-appliance.
• Stimulating phases - [array of 16 ints] 16-elementowa lista z fazami stymulacji dla każdego z pól BCI-appliance.

Zatwierdzenie ustawień przyciskiem OK spowoduje dołączenie bloczka do aktualnej rutyny (ilustracja 3).

Ilustracja 3. Bloczek blinker dodany do aktywnej rutyny

B. Stymulator czuciowy

Stymulator czuciowy to urządzenie umożliwiające generowanie bodźców czuciowych o zadanej częstości i czasie trwania. Biblioteka Psychopy w wersji brain wyposażona jest w oddzielny bloczek do jego obsługi (ilustracja 4).

Ilustracja 4. Bloczek haptic

PAMIĘTAJ!
Przed rozpoczęciem eksperymentu należy podłączyć stymulator do komputera oraz do źródła zasilania. Jeżeli nie podłączysz stymulatora do źródła zasilania lub w trakcie eksperymentu rozłączysz go ze źródłem, urządzenie nie będzie wysyłało bodźców stymulujących, a system tego nie zauważy!

Po wybraniu bloczka wyświetlone zostaje okno zawierające modyfikowalne atrybuty urządzenia (ilustracja 5).

Ilustracja 5. Okno bloczka haptic

Modyfikowalnym parametrem bloczka jest haptic channel. Wskazuje numer kanału, na który ma zostać podany bodziec czuciowy (1-4).

Zatwierdzenie ustawień przyciskiem OK spowoduje dołączenie bloczka do aktualnej rutyny (ilustracja 6).

Ilustracja 6. Bloczek haptic dodany do aktywnej rutyny

C. Parametry linii poleceń

Biblioteka Psychopy w wersji brain zapewnia obsługę parametrów podawanych z linii poleceń. W celu ustawienia parametrów kliknij na ikonę Experiment settings (ilustracja 7).

Ilustracja 7. Experiment settings

W wyświetlonym oknie parametry definiowane są w obszarze Experiment Info (ilustracja 8)

Ilustracja 8. Lista parametrów

Pole Filed odpowiada nazwie parametru, a pole Default jego wartości. Znajdujące się po prawej stronie przyciski ze znakiem plus służą do dodawania kolejnych parametrów, a przyciski ze znakiem minus do ich usuwania.

Jeżeli dany parametr ma przyjmować wartość z linii poleceń należy w polu default tego parametru użyć składni $<num>:<def_val>, gdzie:

• <num> - pozycja parametru w linii poleceń,
• <def_val> - domyślna wartość parametru (wartość przyjmowana w przypadku nie podania wartości w linii poleceń).

Ilustracja 9 przedstawia przykładowy zestaw parametrów.

Ilustracja 9. Przykładowe parametry.

W przykładzie parametr o nazwie param_1 przyjmuje z linii poleceń pierwszą, wpisaną po nazwie pliku wartość i nie posiada wartości domyślnej. Param_2 przyjmuj z linii poleceń drugą, wpisaną po nazwie pliku wartość, a w przypadku braku przyjmuje domyślną wartość 'ala'. Param_3 ma stałą wartość 'kot'.

Po wygenerowaniu kodu, zapisaniu go pod nazwą exp.py i wywołaniu skryptu poleceniem

python exp.py x y z

• param_1 będzie miał wartość x,
• param_2 będzie miał wartość y,
• param_3 będzie miał wartość kot.

Ilustracja 10 przedstawia wywołanie skryptu.

Ilustracja 10. Wywołanie eksperymentu z ilustracji 8 poleceniem python3 exp.py x y z.