Home Publications Certifications LinkedIn GitHub Email

Escape the Frame Trap!

The refresh rate of the monitor is a bottleneck in most experiments. For one, it limits how often the display can be updated. Because experiments typically work in terms of display frames, input values, e.g. from a keyboard, are commonly also obtained once per frame. For button presses this temporal resolution might be enough. But when dealing with continous signals, maybe this isn't the best way to record data.

Essentially, we want to record data at a higher frame rate than the monitor refresh, but still have access to the input so that the display reacts to the input. Eye-tracking studies do this by having the eyetracker work on a seperate process (sometimes a seperate computer), while still allowing the display process to 'talk' to the recording process. We can take the same tactic by starting a dedicated polling thread in our display process. To do this in Python, use the Threading module.

For example, we used the threading method to continously record the trigger states of the Xbox controller's analog triggers.

The readings from the trigger use Pygame, and the clock function is using Psychopy (other timers might work too, but I was using Psychopy for the experiment anyway). You may need a driver to do this (this method was tested with a USB-wired Xbox 360 contoller attached to a PC running Arch Linux, with the xboxdrv package installed.

Then we initialise pygame, the gamepad, and also a file to write the trigger data to.

Then we start the clock/timer. This runs from the start of the experiment till the end.

And we create a function for the threaded polling. Here we are only saving the 2 trigger states and the experiment clock time, but do save what makes sense for you (trial number, which phase of the trial it is, etc)

And before starting the experiment proper, we start the polling function.

The code for the display can go after the polling . This method should give you a consistent 1000hz recording of the analog input, while still being able to call "joyThread.R" or "joyThread.L" in the experiment to determine what feedback to give for the trial, etc. This type of technique might also be useful for other types of inputs, e.g. recording mouse positions at a high and constant rate, useful for cases where you might want to track mouse trajectory later on.

The python code for threading can be found here.