/Thunderdome

Primary LanguageJupyter NotebookGNU General Public License v3.0GPL-3.0

Zebrafish Thunderdome

An open source and versatile spatio-chromatic stimulation system for behavioural experiments

by M.J.Y. Zimmermann, A.M. Chagas, G. Kafetzis & T. Baden


This project is licensed under the GNU General Public License v3.0
The hardware is licensed under the CERN OHL v1.2


This project aims to investigate the larval zebrafish behavioural responses to spatio-chromatic stimulation in a free-swimming environment. The "Thunderdome"© is a stimulation system designed to experiment on the tetra-chromatic larval zebrafish. It is therefore designed around 4 set of LEDs (each LED matching the zebrafish' opsins peak absorption Zimmermann et al. 2018 & Zimmermann et al. 2020, organised in 8 cardinal directions and 4 azimuths. Using machine-learning algorithms, fish motor responses (body direction, eyes orientation, tail kinetics, etc.) are identified and compared to well-known behavioural catalogs ref . The purpose of this project is to identify behavioural responses to specific spatio-chromatic stimulation which were/are studied in early visual system under two photon microscopy ref,ref,ref



Introduction

bonsai


Behaviour tracking

For tracking the larval zebrafish movements, we are considering two different approaches:


Required software


Repository structure

├───3D Designs                                Contains printed parts for the stimulator
|   ├───FreeCad renderings                      - Printing files
|   ├───STL files                               - Printing files
|   └───SCAD files                              - SCAD files to be modified if need be
|
├───Arduino Code                              Stimulator Code
|   ├───Stimulator Code                       - Adaptable C+ code for running the stimulator
|   └───LED driver library                     - Library to run the TLC 5947
|
├───Bill of Materials                         List of necessary components and retailer suggestions
|
├───Bonsai code                               Bonsai pipeline for running the stimulation and export data
|
├───Datasheets                                - Contains all technical sheet for:
|   ├───Stimulator                            - ...micro-controller and LED driver
|   └───Spectrometer                          - ...device used for calibration
|
├───Images                                    Image repository
|
├───Instruction Manual                        Detailed manual to assemble and calibrate the stimulator
|   └───Stimulator Calibration                - Contains calibration recordings and the adaptable jupyter notebook script to calibrate the stimulator
|
├───PCB                                       KiCad and Gerber files to modify and generate PCB
|
└───References                                Publication used to design and conceive this model