Mouse Component

The Mouse component can be used to collect responses from a participant. The coordinates of the mouse location are given in the same coordinates as the Window, with (0,0) in the centre.


This can be used in various ways. Here are some scenarios (email the list if you have other uses for your mouse):

Use the mouse to record the location of a button press

Use the mouse to control stimulus parameters

Imagine you want to use your mouse to make your ‘patch’_ bigger or smaller and save the final size. Call your mouse ‘mouse’, set it to save its state at the end of the trial and set the button press to end the Routine. Then for the size setting of your Patch stimulus insert $mouse.getPos()[0] to use the x position of the mouse to control the size or $mouse.getPos()[1] to use the y position.

Tracking the entire path of the mouse during a period



Everything in a PsychoPy® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

start :

The time that the mouse should first be checked. See Defining the onset/duration of components for details.

stop :

When the mouse is no longer checked. See Defining the onset/duration of components for details.

Force End Routine on Press

If this box is checked then the Routine will end as soon as one of the mouse buttons is pressed.


What information to save, how to lay it out and when to save it.

save mouse state

How often do you need to save the state of the mouse? Every time the subject presses a mouse button, at the end of the trial, or every single frame? Note that the text output for cases where you store the mouse data repeatedly per trial (e.g. every press or every frame) is likely to be very hard to interpret, so you may then need to analyse your data using the psydat file (with python code) instead. Hopefully in future releases the output of the text file will be improved.

time relative to

Whenever the mouse state is saved (e.g. on button press or at end of trial) a time is saved too. Do you want this time to be relative to start of the Routine, or the start of the whole experiment?

new clicks onlybool

Store only new clicks

clickable stimulilist

List of stimulus names within the same routine which can be clicked on

store params for clickedlist

List of parameter names to store from stimuli which are clicked on

See also

API reference for Mouse

Back to top