Button Box Component¶
Button Box: Get input from a button box
- Categories:
Responses
- Works in:
PsychoPy
Note: Since this is still in beta, keep an eye out for bug fixes.
Parameters¶
Basic¶
The required attributes of the stimulus, controlling its basic function and behaviour
- Name
Everything in a PsychoPy® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).
- Start
When the Button Box Component should start, see Defining the onset/duration of components.
- Expected start (s)
If you are using frames to control timing of your stimuli, you can add an expected start time to display the component timeline in the routine.
- Start type
How do you want to define your start point?
Options:
time (s)
frame N
condition
- Stop
When the Button Box Component should stop, see Defining the onset/duration of components.
- Expected duration (s)
If you are using frames to control timing of your stimuli, you can add an expected duration to display the component timeline in the routine.
- Stop type
How do you want to define your end point?
Options:
duration (s)
duration (frames)
time (s)
frame N
condition
- Force end of Routine
Should a response force the end of the Routine (e.g end the trial)?
Device¶
Information about the device associated with this Component. Keyboards, speakers, microphones, etc.
- Device label
A label to refer to this Component’s associated hardware device by. If using the same device for multiple components, be sure to use the same label here.
- Device backend
What kind of button box is it? What package/plugin should be used to talk to it?
- Buttons
Keys to treat as buttons (in order of what button index you want them to be). Must be the same length as the number of buttons.
Data¶
What information about this Component should be saved?
- Register button press on…
When should the button press be registered? As soon as pressed, or when released?
Options:
Press
Release
- Store
Choose which (if any) responses to store at the end of a trial
Options:
Last button
First button
All buttons
Nothing
- Allowed buttons
A comma-separated list of button indices (should be whole numbers), leave blank to listen for all buttons.
- Store correct
Do you want to save the response as correct/incorrect?
- Correct answer
What is the ‘correct’ key? Might be helpful to add a correctAns column and use $correctAns to compare to the key press.
- Save onset/offset times
Store the onset/offset times in the data file (as well as in the log file).
- Sync timing with screen refresh
Synchronize times with screen refresh (good for visual stimuli and responses based on them)
Testing¶
Tools for testing, debugging and checking the performance of this Component.
- Disable Component
Disable this Component