Instructions and End Screen
This documentation describes only one part of an experiment. For other tasks, see the related pages.
Experiment instructions and task description
The first screen displays the instructions for the participant. It typically includes the following information:
A display with instructions for participants in a psycholinguistic experiment should clearly explain the task, the procedure, and any other relevant details. Here's a breakdown of what it should typically contain:
- A brief welcome message.
- The purpose of the experiment (without giving too much away, to avoid influencing responses).
- A clear explanation of what participants are expected to do during the experiment.
- The structure of the experiment (e.g. whether there is an exercise).
- Detailed instructions (e.g. which keyboard buttons to use, whether to enable the camera), what actions to perform (e.g. click on an image, select an answer), and what constraints to consider (e.g. limited time to respond, cannot revisit previous items)
- Examples to demonstrate the task (optional but recommended).
- Instructions on timing and speed (e.g. how fast participants should respond).
- Information about (rest) breaks and the approximate duration of the experiment.
- Contact information
Including all these elements ensures that participants are well-informed, feel comfortable with the task, and can proceed without confusion, leading to cleaner, more reliable data collection.
End screen and goodbye
The end screen serves as the final step in the experiment, thanking participants for their time and participation. It typically includes a brief message of appreciation, a reminder of the study’s purpose, and any final instructions, such as completing a debriefing form or answering post-experiment questions. Providing a clear and friendly conclusion helps ensure a positive participant experience and can offer an opportunity to inform participants about the study’s findings or any follow-up steps. The content of the final screen may also depend on the ethics agreement.
Overview
The following part of the code handles the instructions. It creates a new trial with two elements:
- An
HTML
page with the instructions. - A button for continuing to the next screen or trial.
The .cssContainer()
method adds a 1em margin around both the instruction and the button.
The .print()
method displays the instructions and the button.
The .wait()
method waits until the button is pressed before continuing.
The information contained in this demo is an elaboration and a particular case of the HTML
element described in the PCIbex documentation.
// Instructions
"instructions",
"instructions_text", "instructions.html"
,
"go_to_exercise", "Continue"
;
Dependencies
- Resources
instructions.html
instructions for the participantend.html
purpose of the study, code for compensation, and goodbye- (optional)
logo.png
- Scripts
main.js
- Aesthetics
global_main.css
PennController.css
- Modules
PennController.js
Other modules and aesthetics may be necessary if your experiment uses other trials, e.g. a form for recording participant information.
The content of the instructions.html
file can be adjusted to describe the task. Click on Details to see the contents of the instructions file.
Linguistics Study Demo
Instructions
Your task in this experiment is to read sentences.
These will be shown to you piece by piece.
First, an asterisk ( * ) will appear in the center of the monitor.
Press the SPACEBAR to view the sentence.
At first, you'll see dashes representing the length of the sentence:
___ ___ ____ __ ___ ____
To read the first part of the sentence, press the SPACEBAR :
The cat ____ __ ___ ____
As soon as you press the SPACEBAR again, the next sentence part will appear, and the previous part will disappear.
This will continue until you reach the end of the sentence.
After reading the last part of the sentence, press the SPACEBAR to continue.
___ ___ sits __ ___ ____
___ ___ ____ on the mat.
Read the sentences at your usual speed and make sure you understand the meaning.
Please always keep one finger on the SPACEBAR while reading.
Some sentences will be followed by a question with two answers about the sentence you just saw.
Please answer this question by either clicking on the appropriate answer or pressing 1 (= LEFT ) or 2 (= RIGHT ).
Once you select an answer, you cannot change it.
For example, a question might look like this:
Who or what was mentioned in the sentence?
1 = A cat 2 = A dog
You'll begin by practicing with 9 examples, followed by the actual experiment.
If you have any questions about the task or if you're experiencing technical difficulties, please contact the experimenter:
Anna Pryslopska anna . pryslopska [at] gmail . com
Running the code
To run the experiment, clone or download the repository from GitHub. repository containing the experiment files or download them directly. Alternatively, use this demo link to test the code online before deploying it. Once uploaded, launch the code through PCIbex to start collecting data.