Experiment object

The experiment object is optional. You only need to make one if you want to change a property from default. Note you can also change some default values using pb_prefs.

An object of type experiment provides some options and record properties for the whole experiment, e.g. background color. In an experiment script you can make one outside trials with the command experimentObject and add it with addToExperiment.

Input properties


Default: show opening display and prompt to start

showOpening = <cd>true<cd>/<cd>false<cd>: show opening display and prompt to press Space to start. <cd>false<cd> = open the experiment with a black screen and start it immediately when ready.


Default: black

A 1×3 RGB vector with numbers between 0–1 setting background color for the experiment.​ You can override this for a given trial using trial object property backColor. See also trial object property preTrialBackColor.


Default: current Psychtoolbox settings (standard messages)

A number setting the types of messages Psychtoolbox shows in the MATLAB command window. Note this doesn’t affect all Psychtoolbox messages, but many of them.

<cd>0 <cd> – minimal
<cd>1 <cd> – add error messages
<cd>2 <cd> – add warnings
<cd>3 <cd> – add standard messages
<cd>4 <cd> – add extra messages

This goes to Psychtoolbox Screen('Preference', 'Verbosity') and similar commands. <cd>[]<cd> = current Psychtoolbox settings in case you want to use those commands directly.


Default: current Psychtoolbox setting (0)

An integer ≥ 0 setting MATLAB CPU usage priority. Higher priorities may improve timing precision in experiments where that’s important. This goes to Psychtoolbox Priority. See help text there for more information. <cd>[]<cd> = current Psychtoolbox setting in case you want to use that command directly.

Input properties all objects have


Record properties

PsychBench uses record properties to record information during experiments. You can't set record properties but you can see them in experiment results using input property report.


Experiment duration from trial 1 start to last trial end (sec).