Calibrating Eye/Joystick Signals
Calibration is a process of converting and aligning voltages of input signals to coordinates of visual object space. The first step is to set the physical dimensions of the visual space correctly. Measure the diagonal size of the subject monitor and the distance between the monitor and the subject and put them in the main menu as shown below. NIMH ML then provides you a conversion factor in pixels per degree of visual angle (91.717 in the figure shown below). Use this number to convert the size of visual objects to visual angles. For example, a 320 x 240 movie is [320 240] / 91.717 = [3.4890 2.6167] degrees in visual angles.
NIMH MonkeyLogic currently provides options to use Raw Signal and two calibration methods, Origin & Gain and 2-D Spatial Transformation. The Origin & Gain requires only 2 fixation points and is much easier to use with untrained subjects. The 2-D Spatial Transformation requires sampling voltages for at least 4 fixation points but can do more complex mapping by a projective transform. Both methods include a tool to move and present the fixation point with the mouse. By clicking on yellow squares on the control screen, a fixation point will be displayed in the corresponding location on the subject screen.
There are a few shortcut keys for calibration. These shortcuts work during the task as well.
- [C] key: Brings the current eye position to the center of the screen.
- [U] key: Cancels the previous 'C' key. Undo can be done multiple times.
- [R] key: Delivers a manual reward.
- [-] key: Decreases the reward pulse length by 10 ms.
- [+] key: Increases the reward pulse length by 10 ms.
Raw Signal (Pre-calibrated)
Choose this option when the signals are calibrated already, or to get unaltered input. One volt in the calibrated signals should correspond to one degree of displacement. If the signal is calibrated but the conversion ratio is not one to one, it is possible to do further adjustment with the Origin & Gain method.
Origin & Gain
- To control the user interface on the window, unlock it first by clicking the 'Unlock' button.
- Click the "Show Center" button or the fixation point (yellow square) at the center. It will show a fixation point at the center of the subject screen. Then wait until the subject look at it.
- Click the "Set Origin" button while the subject is looking at the center. Alternatively, you can press the space bar (or 'C' key). It will register the current voltage reading for the center.
- Click one of the fixation points on the periphery. Increase (or decrease) X & Y gains if the subject's saccade undershoots (or overshoots).
- Lock the UI and click the "Save" button. The "Cancel" button reverts any change that has been made.
2-D Spatial Transformation
- Only selected fixation points can be used for this calibration. These fixation points are numbered. To select/unselect fixation points, use the right mouse button. Changing the intervals of fixation points may leave some numbers off of fixation points. Those numbers can only be unselected.
- Once all fixation points have been selected, they can be turned on/off individually with the keyboard (N key & P key) or with mouse left-clicks.
- Hit the space key while the subject is looking at the displayed fixation point. The voltage reading at that moment will be registered for the displayed fixation point and its number will turn from red to blue.
- There is a choice for how to reward fixation. The default option is to deliver reward at the time of the space key press and move to the next fixation point.
- Repeat 2) and 3) for the entire selected fixation points a couple of times. Then click the "Save" button. Eye traces won't appear until there are at least 4 fixation points calibrated.