Overview

Installation

SweetBean can be installed via pip:

pip install sweetbean

Usage

A single Introduction Trial

To create a SweetBean experiment, you define a sequence of stimuli. For example, the following code defines a simple text stimulus to welcome participants. `:

from sweetbean.stimulus import TextStimulus

welcome = TextStimulus("Welcome to the experiment! Press >>Space<< to begin", choices=[" "])

We then use stimuli to create a sequence of events:

event_sequence = [welcome]

From sequences, we can create a block:

from sweetbean.sequence import Block

introduction_block = Block(event_sequence)

Finally, we can create the experiment...

from sweetbean.sequence import Experiment

experiment = Experiment([indroduction_block])

... and export the experiment as html file

experiment.to_html("basic.html")

Mutiple Trials

Let us create a stroop experiment. The trials should start with a fixation cross, followed by a colored word:

from sweetbean.stimulus import TextStimulus, FixationStimulus

fixation_1 = FixationStimulus(duration=500)
stroop_1 = TextStimulus("RED", color="red", choices=["r", "g"])
fixation_2 = FixationStimulus(duration=500)
stroop_2 = TextStimulus("GREEN", color="green", choices=["r", "g"])
fixation_3 = FixationStimulus(duration=500)
...

We can then create a sequence of events and blocks as before.

event_sequence_stroop = [fixation_1, stroop_1, fixation_2, stroop_2, fixation_3, ...]
stroop_block = Block(event_sequence_stroop)
experiment = Experiment([introduction_block, stroop_block])
experiment.to_html("stroop.html")

This way, we could use loops to create experiments with many trials. But a better way is to use the timeline variables: Timeline Variables