How to use PsychoPyComponents¶
Four components are provided by GazeParser PsychoPyComponents.
Name |
Description |
---|---|
GazeParserInit |
|
GazeParserCheck |
|
GazeParserRec |
|
GazeParserMessage |
|
GazeParserGetPos |
|
GazeParserInit¶
This component initialize GazeParser and establish a connection with SimpleGazeTracker. This should be used only once in a single experiment. No other components should not be placed in the routine where GazeParserInit is placed.
In Basic tab of the GazeParserInit property dialog, following parameters can be specified.
Property |
Description |
---|---|
GazeParser configuration file |
Specify GazeParser configuration file. If blank, default configuration file is used. |
GazeParser.TrackingTools configuration file |
Specify GazeParser.TrackingTools configuration file. If blank, default configuration file is used. |
SimpleGazeTracker IP address |
Specify IP address of SimpleGazeTracker to connect with. Input localhost if PsychoPy Builder and SimpleGazeTracker run in the same machine, |
Calibration Area $ |
Specify calibration area. See calArea parameter of
|
Calibration Target Position $ |
Specify a list of calibration target positions. See calposlist parameter of
|
SimpleGazeTracker Data File |
Specify Name of SimpleGazeTracker data file. |
Calibration |
If this property is checked, calibration is performed in this routine. |
Units |
Specify Units of Calibration Area and Calibration Target Position properties. |
In Advanced tab of the GazeParserInit property dialog, following parameters can be specified.
Property |
Description |
---|---|
Mode |
Nomal, Dummy or follow the variable. If Normal, Connection with SimpleGazeTracker is established. If Dummy, GazeParser emulates SimpleGazeTracker. Connection is not established. If follow the variable, Mode Varilable is used to determine whether the experiment run in Normal or Dummy mode. |
Mode Variable |
This property is effective only when Mode is follw the variable. If this value is True, the experiment runs in Dummy mode. Otherwize, runs in Normal mode. This property is useful to switch mode through the Experiment Info dialog. |
Fit Preview Buffer |
If this property is checked, size of preview image buffer is automatically adjusted to the image size of the SimpleGazeTracker's camera unit. Values in GazeParser.TrackingTools configuration file are overwritten. New in 0.8.2 |
Use Monitor Info |
If this property is checked, PsychoPy's monitor info (Screen width, height, dots per centimeter, viewing distance) is sent to SimpleGazeTracker. Values in GazeParser configuration file are overwritten. |
GazeParserCehck¶
This component performs calibration and verification of fixation. This component can be used multiple times in a single experiment, but no other components should not be placed in the routine where GazeParserCheck is placed.
In Basic tab of the GazeParserCheck property dialog, following parameters can be specified. Note that properties except *Calibration mode* are effective only when *Calibraton mode* is not *cal*.
Property |
Description |
---|---|
Target position |
Specify position of the fixation target. |
Max Try |
Specify how many errors are permissible. See
|
Permissible error |
Specify permissible error. See
|
Key |
Specify which key is used to get perticipant's response. |
Mouse button |
Specify which button on the mouse is used to get perticipant's response. |
Units |
Specify Units of Target position and Permissible error. |
Calibration mode |
check, cal+check or cal. check indicates that
|
In Advanced tab of the GazeParserCheck property dialog, message1, message2 and message3 can be specified.
These properties correspond to message parameter of verifyFixation()
function.
GazeParserRec¶
This component starts and stops recording. Only one GazeParserRec should be in a single routine. Recording is started immediately before starting routine, and stopped when the routine is finished. Because starting/stopping recording takes tens of milliseconds, recording cannot be started/stopped during the routine.
In Basic tab of the GazeParserRec property dialog, Message (start) and Message (end) can be specified. This messages are sent to SimpleGazeTracker when recording is started/stopped. In addition to these messages, this component sends a rec-sync message to SimpleGazeTracker. Usually, time stamp of SimpleGazeTracker is tens of milliseconds fast compared with that of PsychoPy Builder. The time when rec-sync message is received by SimpleGazeTracker is about the same as the origin of the PsychoPy Builder's time stamp.
GazeParserMessage¶
This component sends a message to SimpleGazeTracker. This component can be used multiple times in a single routine. Following properties can be specified by the property dialog.
Property |
Description |
---|---|
Start |
Specify when the message is sent. |
start type |
Specify unit of Start property. |
Message text |
The message to be sent. |
GazeParserGetPos (0.8.2 or later)¶
This component gets the latest gaze position from SimpleGazeTracker. This component should be used only once in a single routine because this function takes several milliseconds. The gaze position data is referred to by the "Name" property of this component. Currently, this component supports only monocular data. If SimpleGazeTracker is running in Binocular mode, left and right gaze data are averaged or either of left and right gaze data are obtained.
In Basic tab of the GazeParserGetPos property dialog, Start, Stop and Units can be specified.
Property |
Description |
---|---|
Start |
Same as other PsychoPy components such as TextComponent. |
Stop |
Same as other PsychoPy components such as TextComponent. |
Units |
Units of the gaze position data. |
In Advanced tab of the GazeParserInit property dialog, following parameters can be specified.
Property |
Description |
---|---|
Binocular Data |
This property determines how binocular data is treated. |
Filler |
This value is used when gaze position cannot be detected by SimpleGazeTracker. For example, if this value is -10000, (-10000, -10000) is obtained when gaze position cannot be detected. |
Moving average |
This value must be a positive integer. If this value is N, the latest N samples of gaze position is averaged. |