Notebooks and material for "Electric Brain Signals" written by Geir Halnes, Torbjørn V. Ness, Solveig Næss, Espen Hagen, Klas H. Pettersen and Gaute T. Einevoll, to be published by Cambridge University Press.
These materials are made freely available under the Attribution 4.0 International (CC BY 4.0) LICENSE, unless otherwise noted. Materials derived from other work adhere to the license of the original work (e.g., GPL-3).
Copyright (c) 2022 Torbjørn V. Ness, Espen Hagen, Geir Halnes, Solveig Næss, Klas H. Pettersen, Gaute T. Einevoll.
If you use this material for your published works, please cite it as follows (replace version number and Zenodo-provided DOI accordingly):
Torbjørn V. Ness & Espen Hagen. (2023). LFPy/ElectricBrainSignals: ElectricBrainSignals-1.0.0rc2 (v1.0.0rc2). Zenodo. https://doi.org/10.5281/zenodo.8255422
The citation info for our book will be made available at a later point.
To use these codes, clone this repository by pressing that green button above and follow the instructions.
This repository also uses git LFS for large, non-code files. After cloning the repository, initialize git LFS locally by issuing in the terminal:
cd </path/to/>ElectricBrainSignals
git lfs install
git pull
Overview of files and folders:
- root level
|_ README.md
|_ CHANGELOG.md
|_ CONTRIBUTING.md
|_ setup.py
|_ Dockerfile
|_ requirements.txt
|_ data/ # shared data directory
|_ brainsignals/ # python extension folder
|_ notebooks/ # jupyter notebooks
|_ Ch-1/
|_ Figure-01.ipynb
|_ Figure-02.ipynb
|_ ...
|_ Ch-2/
|_ Ch-.../
|_ Appendix/
|_ Misc/
In the current Python environment, issue
pip install -e .
in order to install the Python package brainsignals
which may be required by the provided Jupyter notebooks.
In case you encounter some problem running these codes, encounter a bug or similar, please do not hesitate to create a new GitHub issue.
-
Don't assume that the user will have write access. If notebooks require modifying local files, do this in
/tmp/
-
Don't put files here that are not ours (neuron model files etc.), or not clearly free for use as we wish. It's better if these can be downloaded by the different notebooks as required.
-
For large binary files (.zip, .tar.gz, .pdf, etc.), make sure that these (and similar files) are tracked using git LFS:
git lfs track "*.<file extension>" git add .gitattributes git add /path/to/binary/file
-
Clear output from notebooks before committing.