/NOW-2023

Repository for the 2023 NeuroScience Open Workshop

Primary LanguageJupyter NotebookMIT LicenseMIT

NOW-2023

Repository for the 2023 NeuroScience Open Workshop.

The online version, published as a Jupyter book can be browsed here.

The notebooks rely on the now-2023 library.

Quick start

If you want to follow the tutorial online, there is nothing to do, just go the jupyter book and run the interactive notebooks on Collab.

If you want to follow on your local machine, we strongly encourage you to build a virtual environment (for example with conda). You can then install the requirements:

$ conda env create -f environment.yml
$ conda activate now
$ pip install -r requirements.txt
$ pip install -r ./jupyter-book/requirements.txt

Schedule

Morning Afternoon Section
09:00-09:30 13:30-14:00 Introduction and setup
09:30-09:45 14:00-14:15 Introduction to Git
09:45-10:30 14:15-15:00 Version your code with Git
10:30-10:45 15:00-15:15 Break
10:45-11:00 15:15-15:30 Introduction to DVC
11:00-11:30 15:30-16:00 Version code and data with DVC
11:30-12:00 16:00-16:30 Version your experiments as data pipelines

Contributing

Build all the notebooks

Once your changes are done in the scripts (the src files) run at the root folder:

make

This command will recreate automatically the notebooks and clean the outputs.

Build the jupyter-book

You need to install the requirements:

$ pip install -r jupyter-book/requirements.txt

Then:

$ cd jupyter-book
$ make

The HTML files are then in jupyter-book/_build/html/.

External ressources