Self-paced reading template
To install this experiment template, use the command
pushkin install experiment, then select reading.
Self-paced reading experiment template, with the setting "moving word" (see below for details)
comprehension: If
true, each self-paced reading trial will be followed by a two-alternative forced-choice comprehension question. If false, the experiment goes right to the next self-paced reading trial.correctiveFeedback: If
true, participants will get feedback after answering each comprehension question which indicates whether their response was correct or incorrect. If false, no feedback will follow the comprehension questions. This parameter has no effect if comprehension questions are not being displayed.sentence: The sentence or text to be read. See above for details on how to note what chunks of words should be displayed together for a self-paced reading display rate.
comprehension: A list containing the specifications for the comprehension questions. The first element is the question itself, the second is the correct answer, and the third is the incorrect answer. The correct and incorrect answers are randomly assigned the the 'F' and 'J' keys in experiment.js.
If you have installed an experiment using the self-paced reading experiment template and called it
spr, you should have a directory called spr in your experiments folder. This directory should be structured like this:spr
├── api controllers
├── config.yaml
├── LICENSE
├── migrations
├── README.md
├── web page
└── worker
In order to customize your self-paced reading experiment, you will need to access two files,
config.js and stim.js. These files can be found in web page/src/, a directory that looks like this:src
├── assets
├── config.js
├── consent.js
├── debrief.js
├── experiment.js
├── index.js
└── stim.js
This file controls the aesthetics of your experiment, including font color, font size, and font family. If you wanted to set the font color to
blue, set the font size to 36px, and set the font family to a serif font such as Palatino Linotype, you would modify config.js as follows:const experimentConfig = {
fontColor: "blue",
fontSize: "36px",
fontFamily: "'Palatino Linotype', Palatino, serif",
comprehension: true,
correctiveFeedback: true, // Only relevant if comprehension is set to true
};
export default experimentConfig;
Note that any font-related changes you make to
config.js will not affect the font in the actual self-paced reading trials. To modify that font (and other plugin parameters), you will need to edit the trial in experiment.js. See the plugin documentation for details.You can run
pushkin prep and pushkin start to see your changes.This file controls the self-paced reading sentences and comprehension questions (if relevant) presented to participants. Create a new table of sentences and comprehension questions for your experiment, with your comprehension questions in a three-element list (i.e. ['question' , 'correct answer', 'incorrect answer']). Then use a table-to-JSON converter such as this one to format it correctly for jsPsych and paste the array into the
stim.js file. Run pushkin prep and pushkin start again, and your experiment should be ready to go!