Manual Task Execution

Tasks Training Village screen

To launch a task, navigate to the TASKS tab. If you have not yet created a new project, you will be working within the demo-village-project by default. This project includes several example tasks that cover a range of system functionalities.

Demo Tasks

The following tasks are included. Note that some require additional hardware beyond the Raspberry Pi itself.

Requires a Bpod with 3 behavioral ports (BEHAVIOR_CONTROLLER set to BPOD):

Requires an Arduino (BEHAVIOR_CONTROLLER set to OTHER):

No external controller required (BEHAVIOR_CONTROLLER set to OTHER):

Training protocol (training_protocol.py):

  • Moves each subject through the six Bpod stages of Follow the Light, deciding the next task after every session.


Launching a Task

The TASKS screen shows the active training protocol on the left, along with a list of all available tasks. When you click on a task, its description (self.info) is displayed, along with its settings, organized in the tabs defined by the training protocol (see The Training Protocol). Two more fields are shown:

  • maximum_number_of_trials: The task will automatically end once this number of trials is completed. It only exists for manual runs: it is not a setting of the training protocol, it is not saved, and it has no effect on the sessions run automatically (to limit the trials in those, see Ending the session from the task).

  • maximum_duration: The task will automatically end when this time is reached. Unlike the previous one, it is a setting of the training protocol, used in automatic sessions too.

You can optionally select a subject from the Subject selector, next to the RUN TASK button, before running it:

  • No subject selected (None): The task runs with the default settings defined in training_protocol.py. No data or video is saved.

  • Subject selected: The task runs with the settings currently assigned to that subject. Once the session ends, the subject’s settings are updated automatically by training_protocol.py.

Warning

When a subject is selected, the values you change before pressing RUN TASK (maximum_duration or any other setting) are kept for that subject: they become its settings for the next sessions, automatic ones included, unless update_training_settings() reassigns them at the end of the session (see update_training_settings()).

Press RUN TASK to start.


Testing the Training Protocol

Clicking TEST THE TRAINING PROTOCOL simulates what would happen if training_protocol.py were applied to a specific subject right now, based on their existing session history. The computed settings for the next session are displayed on screen.

This is intended as a validation tool: if you have modified training_protocol.py, you can use this to verify that the updated code runs correctly against real subject data without making any actual changes. The settings displayed are never saved or applied.