FAQ about the jspsych-psychophysics plugin
1. Can I change the center of the window (canvas) to the origin of the coordinates?
Yes. Normally, the origin of the coordinate is the top left of the canvas. But the origin can be changed to the center of the window setting the origin_center property as true. The unit is the pixel.
2. Can I specify the stimulus presentation time in terms of number of frames rather than milliseconds?
Yes. If you want to control the presentation time strictly, it is better to specify the presentation time with frames instead of milliseconds. If the is_frame property is true, the plugin tries to present the stimulus for the specified frame.
3. How many frames of stimuli will the plugin present if I specify a presentation time of 40 ms?
If the is_frame property is false, i.e., if the presentation time is specified in ms, the plugin presents the stimulus according to the following calculation.
Using the requestAnimationFrame method the time since the methods was first called, is measured. If the time is greater than or equal to show_start_time but less than show_end_time, the stimulus is presented.
Therefore, for example, the presentation time of 40 ms is specified, the stimulus is expected to be presented for two frames (about 33.4ms).
However, this prediction is not consistent with the actual results which was measured using the Black Box tool kit. Please see my OSF page
For example, the histograms of the 20-ms display duration condition which was measured on a ProBook (Windows laptop 64 bit) with the jspsych-psychophysics plugin was almost consistent with the prediction. On the other hand, the histograms of the 20-ms display duration condition which was measured on a MacBook Pro with the jspsych-psychophysics plugin showed multimodal distributions, with an interval of one frame.
If you want to control the presentation time strictly, it is better to specify the presentation time in terms of frames instead of milliseconds.
4. I can’t present audio stimuli at all.
Perhaps you are running the program on your local computer.
You should upload the files to a web server to use the WebAudio. This is mentioned at the jsPsych forum.
And, you should turn on the WebAudio for accurate presentation of audio stimuli.
5. I can’t prepare a web server.
Cognition is one of the most promising options.
6. Can I record where the participants click?
Yes. See the demos/localize-circle.html. The origin of the coordinate is the top left of the canvas. The coordinates of the center of the canvas are recorded at the same time.
7. Can I specify the mouse/keyboard event handler?
Yes. See the demos/mouse_drawing.html, the demos/mouse_event.html, the demos/keyboard_event.html, and the demos/visual_stimuls_terminates_earlier_than_audio.html. The mousedown, mouseup, and mousemove on the canvas and the keydown and keyup on the document are supported.
To add event handlers not supported by the plugin, touch_to_end.html will be helpful.
However, there are cases where it is better not to use these event handlers. See this issue.
8. The jsPsych.timelineVariable function which specified in a stimulus object does not work properly.
See the demos/how_to_timeline_variables.html and demos/response_start_time_depends_on_onsets.html
9. How can I change properties of the stimulus dynamically?
There are three ways to do that.
First, you can specify the property using a function. See the Nested parameters and demos/dynamically_change.html
Second, you can use the stimuli
when you want to change properties of the stimulus at the begging of the trial. See demos/randomize_show_start_time.html and demos/rsvp.html.
Third, you can use the stim_array
when you want to change properties of the stimulus during the trial (e.g. using the event handlers or the requestAnimationFrame methods). See the demos/mouse_event.html, the demos/keyboard_event.html, the demos/draw_two_images_repeatedly.html, and the demos/visual_stimuls_terminates_earlier_than_audio.html
10. What is the avg_frame_time?
The avg_frame_time is the value of an elapsed time divided by the number of times the requestAnimationFrame was called. The elapsed time is the time when the requestAnimationFrame was last called minus the time when the requestAnimationFrame was first called. So, the avg_frame_time is a measure of how accurately the stimuli were presented. When using a display with a refresh rate of 60 Hz, theoretically the avg_frame_time would be 16.7 ms. However, when the load of stimulus presentation was high, the avg_frame_time would exceed 16.7ms. The large avg_frame_time means that the stimulus could not be presented in the expected time.
11. Is there a way to control stimulus size and viewing distance in online experiments?
Yes, there is. Please use the jspsych-virtual-chinrest plugin. This plugin is included in the jsPsych library.