imMobilize consists of open software and hardware designed to collect video data of small free swimming animals, and administer various stimuli in an accurate and automated manner. This system was developed for experiments with the tunicate Ciona intestinalis
For the list of hardware, schematics and buildguide, please look at the hardware guide
Due to camera compatibility, imMobilize is currently only available for Windows. imMobilize is written in python and requires python 3.5+ to be installed on the system. To install imMobilize, run
git clone https://github.com/DanielDondorp/imMobilize.git
or download this repository and extract the .zip file.
Enter the newly created directory (cd imMobilize
) and install the required dependencies by running pip install -r requirements
. We recommend doing this in a virtual environment.
To start the program, run
python3 ./imMobilize/__main__.py
You should see a python console and the imMobilize Camera Window open up.
In the camera window, you can connect to the cameras available on your system. The controls for the connected camera and the imaging light intensity are located on the left hand side of this window. The controls on the bottom left allow for simple video recording with the connected camera.
On the right hand side are the controls for connecting to the detected microcontrollers. The line-edit widget in this control group can be used to send commands to the microcontroller directly. Available commands are:
- 'wS' - Switched on the white light source
- 'wC' - Clears/Switches of the white light source
- 'nXXXXXXXXX' - where each X is an integer 0-9. switches on coloured light. The nine provided digits are interpreted as RGB values, eg 'n000255000' switches on green light
- 'nC' - Clears/Switches off coloured light
- 'iXXX' -where X is an integer 000-255. Controls strength of the infrared imaging light
By activating "Read Serial Live" you can read out the temperature sensors of the specific setup live in the plot window.
Clicking on the 'Experiment Settings' tab will get you to the Experiment Window.
In this window the user can design an experiment by adding various stimuli to the experiment timeline, and filling out the experiment metadata. Stimuli profiles can be saved and later loaded and applied to new experiments. When all settings are applied to satisfaction, clicking "Start Experiment" records a single experiment. If you wish to record multiple experiments of the same animal without coming back to the setup this can be achieved by setting the number of experiments in the "LazyMode" controls. This will repeat the set experiment a specified number of times.