Cedrus logo

Documentation

A Good Tutorial

‍The Plan

‍In this tutorial, we build a word/non-word experiment that will present instructions to the participant followed by six trials. Each trial will consist of a cue and stimulus.

‍When developing your own experiments, plan carefully and take advantage of the stimulus lists feature. This can save you time, will make it easier to see the structure of your experiment and maintain it, and will make analyzing the data easier later on.

‍This is worth emphasizing: you should use stimulus lists whenever possible. Not only it will save you time, you can add new items to a list without affecting the experimental design. You also get more options, e.g. two-level randomization.

‍Assuming you have read Getting Started with SuperLab, let’s start.

‍Participant Input

‍In this experiment, the participant is expected to press the letter “y” (for yes) if it’s a word or “n” if it is not a word. Let’s start by defining these two keys as responses:

  • In the sidebar, click on Input.
  • At the bottom click on the + icon.
  • SuperLab will create a response with a default name that is ready to be edited; type “Yes”.
  • Click on the edit field that is after “the following key” and type “y”.

‍You have created the first response.

‍        [INSERT SCREENSHOT HERE]

‍Now create the second one by clicking on the + icon again, rename the new response to “No”, and set the key to “n”.

‍Experiment Structure

‍This diagram illustrates the structure of the experiment we want to build:

‍Notice how “Word Trial Design” and “Non-Word Trial Design” are represented using stacked rectangles. This indicates that the design uses at least one stimulus list, resulting in multiple presentations; more below.

‍Creating “Words Design”

‍When you open a new experiment, SuperLab creates two trial designs: “Instructions” and “My Design”:

‍1. In the sidebar, click on Trial Designs.

‍2. Double-click on “My Design” to edit it.

‍3. Type “Words Design” then press Enter.

‍4. Click on the Edit Design button; you can also double-click on the design thumbnail.

‍This will launch the trial designer. The default design that SuperLab had created contains two slides named “Cue” and “Stimulus”.

‍        [INSERT SCREENSHOT HERE of the trial design, perhaps upper part only]

‍1. The Cue slide is set to appear for 500 milliseconds; you can change that in the inspector (in the Slide tab).

‍2. Click on the “Stimulus” slide to select it.

‍3. In the black bar, click on the “open toolbox” Circle Plus icon; the toolbox appears.

‍4. Click on the icon for Text. SuperLab will display a dialog so you can provide the text.

‍This dialog has two tabs. In the This Text tab, you canprovide instructions or any other text that does not require a list. But for our purpose:

‍        [INSERT SCREENSHOT HERE of the text editing dialog]

  • Click on the Use a List tab.
  • Type the list items:
       apple
       plane
       train
  • Click on the Next Caret Right  button. SuperLab will prompt you to give this list a name; type “Words”.
  • Click on OK.
  • In the black bar, click on the checkbox Circle Check to close the toolbox.

‍Feel free to adjust the font size or other text properties. Note that we have just added text to the slide and created a stimulus list on the fly.

‍Creating stimulus lists on the fly is a great time-saving feature. It’s not just for text: you can create lists on the fly for pictures, audio, and movies as well.

‍We need to do one more thing with this design: to tell SuperLab what is the correct response:

‍    <<<<<  insert screenshot of dialog >>>>>

  • In the Inspector, click on the Slide tab.
  • Click on the pencil icon button Pencil next to Correct Response; a dialog appears.
  • SuperLab can detect the correct response based on a number of things. Click on the Determined by a stimulus list radio button.
  • Click on OK.

‍Click on the Close Trial Designer button.

‍Creating “Non-Words Design”

‍We are now back in the main window. Let’s create the trial design for non-words:

  • In the main window, select “Words Design” if it is not already selected.
  • Click on the duplicate trial design icon. The name of the new copy is ready to be edited.
  • Type “Non-Words Design” and press Enter.
  • Double-click on the design thumbnail or click on the Edit Design button; the trial designer will open.
  • Select the second “Stimulus” slide.
  • Select the existing text object.
  • In the black bar, click on the delete icon Square Minus
  • In the black bar, click on the “open toolbox” Circle Plus icon; the toolbox appears.
  • Click on the icon for Text. SuperLab will display the dialog for editing the text.
  • Click on the Use a List tab.
  • Type
       neibs
       quihs
       chortz
  • Click on the Next Caret Right  button. SuperLab will prompt you to give this list a name. Type “Non-Words”.
  • Click on OK.
  • In the black bar, click on the checkbox Circle Check to close the toolbox.
  • We still need to set the correct response. In the Inspector, click on the Slide tab.
  • Click on the pencil icon button Pencil next to Correct Response; a dialog appears.
  • Click on the Determined by a stimulus list radio button.
  • Click on OK; the dialog closes.
  • Click on Close Trial Designer button.

‍We have completed the needed trial designs for a word / non-word paradigm.

‍Updating the Instructions

‍SuperLab automatically creates a block, a trial, and a trial design for participant instructions. All we need to do is edit it:

  • In the sidebar, click on Trial Designs in case you’re not there already.
  • Select the design “Instructions”.
  • Click on the Edit Design button to open the trial designer.
  • The slide contains two text objects; double-click on the bottom one to edit; a dialog appears.
  • Select the entire contents of the edit field and type: “In this task, text will be presented. Some are valid words and some are not. Press the letter Y if you think it’s a valid word, or the letter N if you don’t think it is.”
  • Click on OK to close the text editor.
  • Click on Close Trial Designer button.

‍Setting the Correct Response

‍If you were a participant in this experiment, you will not see a difference whether the correct response is set or not. But this is an important step to complete:

  • Collected data files include an “Error Code” column. When the correct response is set for a slide, SuperLab will code the response for you, e.g. “C” if the response is correct or “E” if it’s not.
  • You can choose to advance to the next slide only if a response is correct.
  • You can provide feedback based on the correctness of the response.

‍Let’s proceed:

‍             [INSERT SCREENSHOT HERE]

  • In the side bar, click on Stimulus Lists. You will see the two lists that we created on the fly in the trial designer. The first one, “Words”, is already selected.
  • Click on the Responses tab; you will see the two “Yes” and “No” responses that we created earlier.
  • Click on the checkbox for “Yes”.

‍Now let’s do the same for the “Non-Words” list.

  • Click on the List & Items tab.
  • Click on the “Non-Words” list to select it.
  • Click on the Responses tab.
  • Click on the checkbox for the “No” response.

‍In summary: the correct response is to press “y” when the participant sees a word or “n” when it’s a non-word.

‍In the Responses tab, notice the checkbox Correct response is the same for all items in the list. Use this option whenever possible. This way, you can add list items without having to remember to set the correct response every time.

‍We are almost done.

‍The Trials

‍In sidebar, click on Experiment.

  • Click on the trial “Trials”; it is using “Words design” already.
  • Double-click on “Trials”. The trial editor appears.
  • In the edit field, rename it to “Word trials”.
  • Click on the Back button.
  • Click on the Square Plus icon to create a new trial. SuperLab will name it “Trial 1” by default.
  • Double-click on “Trial 1” to edit it.
  • Rename it to “Non-word trials”.
  • Click on the Back button.
  • Under the label “Use This Trial Design”, change the design to “Non-words design”.

‍The trials are now all setup. We’re almost there.

‍The Experiment

‍Lastly, we need to have the block include both trials.

  • Click on the block “Block 1”.
  • Notice how the trial “Word trials” is checked Square Check but “Non-word trials” is not.
  • Click on the checkbox for “Non-word trials”.

‍“Block 1” now includes both word and non-word trials. There is one last step but an important one:

  • Double-click on “Block 1” to edit it.
  • Enable the option Randomize trials in this block.
  • Click on the Back button.
  • Click on the File menu and select Save. This is important otherwise SuperLab will not save collected data.

‍Congratulations! The experiment is now complete.

‍Running The Experiment

‍Click on the Ready to Run… button. SuperLab will present some options:

‍     <<<<< insert screenshot, perhaps of the top half only >>>>>

‍For now, we suggest you enable the option Run in Pilot mode. SuperLab saves all the collected data in a folder. This folder contains a subfolder named “Pilot”. When you run an experiment in pilot mode, the data is saved in the “Pilot” subfolder. This helps you separate data that you yourself collect to verify that the experiment is working well from the actual data that is collected from participants.

‍Do not worry if you make a mistake with pilot mode; you can always move a data file out of the “Pilot” subfolder. See Data Files for a description of how data is stored.

‍And last but not least, click on the Run button. SuperLab will open a window that covers the entire screen. Act as a participant and press the Y or N keys until the experiment is complete.

‍When done, click on the Data tab to see the result of your run:

‍     <<<<< insert screenshot of data viewer >>>>>

‍Not the checkbox Show pilot data. This is how can view pilot data versus participant data.

‍Congratulations

‍Back in the main SuperLab Documentation page, you will find a number of other documents that describe specific features.

Tip icon, emphasizing that you should use stimulus lists whenever possible.
Tip icon, to emphasize creating a stimulus list on the fly while creating the object.
Tip icon, to emphasize using the same correct response for all items in a stimulus list.

A Good Tutorial

PRODUCTS

SUPPORT

STAY IN TOUCH

© Copyright 2026 Cedrus Corporation, P.O. Box 6309, San Pedro, CA 90734 - USA

Phone: +1-310-548-9595. Send us an email Envelope. See privacy policy.

qwerasdf