1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
Overview
========
**Expyriment** is an open-source and platform independent light-weight Python
library for designing and conducting timing-critical behavioural and
neuroimaging experiments. The major goal is to provide a well-structured Python
library for a script-based experiment development with a high priority on the
readability of the resulting programme code. It has been tested extensively
under Linux and Windows.
**Expyriment** is an all-in-one solution, as it handles the stimulus
presentation, recording of I/O events, communication with other devices and the
collection and preprocessing of data. It offers furthermore a hierarchical
design structure, which allows an intuitive transition from the experimental
design to a running programme. It is therefore also suited for students as well
as experimental psychologists and neuroscientists with little programming
experience.
*Website*: http://www.expyriment.org
*Authors*
* `Florian Krause <http://www.dcc.ru.nl/anc/index.php?staff=krause>`_, Radboud
University Nijmegen, The Netherlands
* `Oliver Lindemann
<http://www.psych.uni-potsdam.de/people/lindemann/index-e.html>`_, University
of Potsdam, Germany
Main features
-------------
* Easy syntax, very readable (due to Python)
* Cross-platform (Linux, Windows, OS X)
* Allows for fast and efficient programming of experiments (do more with less
code)
* A variety of standard stimuli (Text, Picture, Audio, Video etc.)
* Keyboard, Mouse, Serial Port, Parallel Port and Gamepad support
* Hierarchical structure of experimental units (Experiment, Blocks, Trials, Stimuli)
.. image:: expyriment_structure.png
For a full documentation of all Expyriment functionality (i.e. all available
modules, classes, methods, functions, constants, and attributes provided by the
Expyriment Python package), please have a look at the :doc:`API reference pages
<expyriment>`
Example code
------------
Examples of full experiments can be found :doc:`here <Examples>`
Creating experiments, blocks, trials and stimuli::
exp = expyriment.design.Experiment()
block = expyriment.design.Block()
trial = expyriment.design.Trial()
stimulus = expyriment.stimuli.TextLine(text="Hello World")
Building a hierarchy between various structures::
trial.add_stimulus(stimulus)
block.add_trial(trial)
exp.add_block(block)
Presenting stimuli::
for block in exp.blocks:
for trial in block.trials:
trial.stimuli[0].present()
Handling input devices::
button, rt = exp.keyboard.wait([expyriment.misc.constants.K_SPACE])
Logging data::
exp.data.add([button, rt])
Licence
-------
Expyriment is free software and released under the Open Source `GNU General
Public Licence <http://www.gnu.org/copyleft/gpl.html>`_ of the Free Software
Foundation.
Publications & Citation
-----------------------
If you have used Expyriment in your work, please cite the follwing
publication:
Krause, F. & Lindemann, O. (2013). Expyriment: A Python library for cognitive
and neuroscientific experiments. *Behavior Research Methods.*
`doi:10.3758/s13428-013-0390-6 <http://dx.doi.org/10.3758/s13428-013-0390-6>`_
.. FIXME update BRM publication details
Development repository
----------------------
The `Expyriment development repository
<https://github.com/expyriment/expyriment>`_ is currently hosted on
GitHub. Get a local copy of this repository with this command::
git clone https://github.com/expyriment/expyriment.git
Mailing lists
-------------
**Expyriment newletter**: All users of Expyriment should subscribe to the
Expyriment newsletter, since the project is still under development. All
modifications and new versions will be announce via this mailing list. (Visit
`website <http://groups.google.com/group/expyriment>`_ or send an email
to expyriment+subscribe@googlegroups.com).
**Expyriment users mailing list**: If you have questions regarding the
installation, usage or documentation of Expyriment please don't hesitate to
contact the Expyriment users mailing list (visit `website
<http://groups.google.com/group/expyriment-users>`_ or send an email to
expyriment-users+subscribe@googlegroups.com) or contact us directly by sending
an email to info@expyriment.org.
Suggestions and bug tracking
----------------------------
If you want to make suggestions to improve Expyriment or you found a bug,
please post your comments to the `Expyriment issues page
<https://github.com/expyriment/expyriment/issues>`_ or contact us directly by
sending an email to info@expyriment.org.
Related Projects
----------------
If you are looking for a graphical experiment builder, we suggest OpenSesame,
which uses Expyriment as the default back-end: http://www.osdoc.cogsci.nl/.
|
