Skip to main content

OpenSesame Plug-in: Experiment Manager

An OpenSesame plug-in for managing/executing multiple OpenSesame experiments.

Copyright (C) 2015-2026 Bob Rosbag

About

This plug-in can insert standalone OpenSesame Experiments within a main experiment. It can run within a loop or sequence as an item. This makes it possible to run a number of experiments in sequence (random or fixed order) and also it gives the possibility to give each experiment its own (different) backend.

This plug-in has three options:

  • Dummy mode for testing experiments.
  • Verbose mode for testing experiments.
  • Experiment filename full path or filename.

The started experiment runs fullscreen. The main experiment can also run fullscreen with the PsychoPy backend. With the legacy backend, run the main experiment windowed: in fullscreen it may not get the keyboard back after the started experiment ends (seen on Linux). The experiment file is looked up in the folder of the log file first, and then in the file pool (which includes the folder of the main experiment). The filename may be a variable, for example set by an earlier item. The started experiment uses the subject number of the main experiment and writes its log file to <filename>_-_subject-<nr>.csv in the folder of the main log file (with a full path as filename: in the folder of the experiment file).

If the started experiment fails, or its file does not exist, the main experiment stops with an error. If the participant aborts the started experiment (Escape, then Q), a warning is logged and the main experiment continues.

Running an experiment without the GUI

The experiment is started with run_experiment.py, which is part of this plug-in. It can also be used on its own, as a replacement for opensesamerun (which no longer works in OpenSesame 4.1). Use the Python interpreter of OpenSesame:

python run_experiment.py experiment.osexp --subject=3 --logfile=log.csv --fullscreen

Exit codes: 0 = finished, 1 = error, 2 = invalid arguments, 3 = aborted by the user.

License

This plugin is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version (GPL-3.0-or-later).

The full license text is in the file COPYING, and is also available at https://www.gnu.org/licenses/gpl-3.0.html.

Documentation

Installation instructions and documentation on OpenSesame are available on the documentation website:

Metadata

Release files for opensesame-plugin-experiment-manager 4.0.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for opensesame-plugin-experiment-manager 4.0.5
File Size Uploaded Provenance Actions
opensesame_plugin_experiment_manager-4.0.5.tar.gz 20.6 kB Without provenance Details for opensesame_plugin_experiment_manager-4.0.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for opensesame-plugin-experiment-manager 4.0.5
File Interpreter ABI Platform Actions
opensesame_plugin_experiment_manager-4.0.5-py3-none-any.whl Python 3 none any Details for opensesame_plugin_experiment_manager-4.0.5-py3-none-any.whl

Total release size: 44.3 kB

Release files / opensesame_plugin_experiment_manager-4.0.5.tar.gz

Download URL opensesame_plugin_experiment_manager-4.0.5.tar.gz
Size 20.6 kB
Tags Source
SHA-256 checksum
How to use checksums
9067eeced4b57638aacc5ceae5f279a0fcefb54598ea1ca902d22cf529322f95
BLAKE2b-256 checksum
How to use checksums
dab4a4108d858e75f0f3d5ac53b09e0e5962f7d05edd41e7d1bff543a7cf43e4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Release files / opensesame_plugin_experiment_manager-4.0.5-py3-none-any.whl

Download URL opensesame_plugin_experiment_manager-4.0.5-py3-none-any.whl
Size 23.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ccb56ee8603b4ef98b974afc8716942acd72504b4de19d20b6a351bd26045689
BLAKE2b-256 checksum
How to use checksums
7dfde026f9fe9281fe7de7f5d730b1a5306e46a322225c0dc3874be6139b5c29
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.1.0 CPython/3.13.5

Security for opensesame-plugin-experiment-manager 4.0.5

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page