|banner|
BlueCelluLab
============
+----------------+------------+
| Latest Release | |pypi| |
+----------------+------------+
| Documentation | |docs| |
+----------------+------------+
| License | |license| |
+----------------+------------+
| Build Status | |tests| |
+----------------+------------+
| Coverage | |coverage| |
+----------------+------------+
| Gitter | |gitter| |
+----------------+------------+
| Citation | |zenodo| |
+----------------+------------+
The Blue Brain Cellular Laboratory is designed for simulations and experiments on individual cells or groups of cells.
Suitable use cases for BlueCelluLab include:
* Scripting and statistical analysis for single cells or cell pairs.
* Lightweight, detailed reporting on specific state variables after simulation.
* Developing synaptic plasticity rules.
* Validating dynamics of synaptic properties.
* Automating in-silico whole-cell patching experiments.
* Debugging, both scientifically and computationally.
Citation
========
When you use this BlueCelluLab software for your research, we ask you to cite the following reference(this includes poster presentations):
.. code-block::
@software{bluecellulab_zenodo,
author = {Van Geit, Werner and Tuncel, Anil and Gevaert, Mike and Torben-Nielsen, Benjamin and Muller, Eilif},
title = {BlueCelluLab},
month = jul,
year = 2023,
publisher = {Zenodo},
doi = {10.5281/zenodo.8113483},
url = {https://doi.org/10.5281/zenodo.8113483}
}
Support
=======
We are providing support on `Gitter <https://gitter.im/BlueBrain/BlueCelluLab>`_. We suggest you create tickets on the `Github issue tracker <https://github.com/BlueBrain/BlueCelluLab/issues>`_ in case you encounter problems while using the software or if you have some suggestions.
Main dependencies
=================
* `Python 3.8+ <https://www.python.org/downloads/release/python-380/>`_
* `Neuron 8.0.2+ <https://pypi.org/project/NEURON/>`_
Installation
============
BlueCelluLab can be pip installed with the following command:
.. code-block:: python
pip install bluecellulab
Quick Start
===========
The following example shows how to create a cell, add a stimulus and run a simulation:
.. code-block:: python
from bluecellulab.cell import create_ball_stick
from bluecellulab import Simulation
cell = create_ball_stick()
sim = Simulation()
sim.add_cell(cell)
stimulus = cell.add_step(start_time=5.0, stop_time=20.0, level=0.5)
sim.run(25, cvode=False)
time, voltage = cell.get_time(), cell.get_soma_voltage()
# plotting time and voltage ...
.. image:: https://raw.githubusercontent.com/BlueBrain/BlueCelluLab/main/docs/images/voltage-readme.png
:alt: Voltage plot
Tutorial
========
A more detailed explanation on how to use BlueCelluLab, as well as other examples can be found on the `examples page <https://github.com/BlueBrain/BlueCelluLab/blob/main/examples/README.rst>`_.
API Documentation
=================
The API documentation can be found on `ReadTheDocs <https://bluecellulab.readthedocs.io>`_.
Running the tests
=================
Testing is set up using `tox`:
.. code-block:: bash
pip install tox
tox -e py3 # runs the tests
tox -e lint # runs the format checks
Funding & Acknowledgements
==========================
The development and maintenance of this code is supported by funding to the Blue Brain Project, a research center of the École polytechnique fédérale de Lausanne (EPFL), from the Swiss government's ETH Board of the Swiss Federal Institutes of Technology.
Copyright
=========
Copyright (c) 2023 Blue Brain Project/EPFL
This work is licensed under `Apache 2.0 <https://www.apache.org/licenses/LICENSE-2.0.html>`_
For MOD files for which the original source is available on ModelDB, any specific licenses on mentioned on ModelDB, or the generic License of ModelDB apply.
The licenses of the morphology files used in this repository are available on: https://zenodo.org/record/5909613
.. |license| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
:target: https://github.com/BlueBrain/BlueCelluLab/blob/main/LICENSE
.. |tests| image:: https://github.com/BlueBrain/BlueCelluLab/actions/workflows/test.yml/badge.svg?branch=main
:target: https://github.com/BlueBrain/BlueCelluLab/actions/workflows/test.yml
:alt: CI
.. |pypi| image:: https://img.shields.io/pypi/v/bluecellulab.svg
:target: https://pypi.org/project/bluecellulab/
:alt: latest release
.. |docs| image:: https://readthedocs.org/projects/bluecellulab/badge/?version=latest
:target: https://bluecellulab.readthedocs.io/
:alt: latest documentation
.. |coverage| image:: https://codecov.io/github/BlueBrain/BlueCelluLab/coverage.svg?branch=main
:target: https://codecov.io/gh/BlueBrain/bluecellulab
:alt: coverage
.. |gitter| image:: https://badges.gitter.im/Join%20Chat.svg
:target: https://gitter.im/BlueBrain/BlueCelluLab
:alt: Join the chat at https://gitter.im/BlueBrain/BlueCelluLab
.. |zenodo| image:: https://zenodo.org/badge/640805129.svg
:target: https://zenodo.org/badge/latestdoi/640805129
..
The following image is also defined in the index.rst file, as the relative path is
different, depending from where it is sourced.
The following location is used for the github README
The index.rst location is used for the docs README; index.rst also defined an end-marker,
to skip content after the marker 'substitutions'.
.. substitutions
.. |banner| image:: https://raw.githubusercontent.com/BlueBrain/BlueCelluLab/main/docs/source/logo/BlueCelluLabBanner.jpg
Raw data
{
"_id": null,
"home_page": null,
"name": "bluecellulab",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "computational neuroscience, simulation, analysis, SONATA, neural networks, neuron, Blue Brain Project",
"author": "Blue Brain Project, EPFL",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/85/05/d1d49c4ec8bc37e1f2e9320b660a9b059ab0ca5eb9e0ca443d978ff31c7c/bluecellulab-2.6.13.tar.gz",
"platform": null,
"description": "|banner|\n\nBlueCelluLab\n============\n\n+----------------+------------+\n| Latest Release | |pypi| |\n+----------------+------------+\n| Documentation | |docs| |\n+----------------+------------+\n| License | |license| |\n+----------------+------------+\n| Build Status \t | |tests| |\n+----------------+------------+\n| Coverage | |coverage| |\n+----------------+------------+\n| Gitter | |gitter| |\n+----------------+------------+\n| Citation | |zenodo| |\n+----------------+------------+\n\n\nThe Blue Brain Cellular Laboratory is designed for simulations and experiments on individual cells or groups of cells.\nSuitable use cases for BlueCelluLab include:\n\n* Scripting and statistical analysis for single cells or cell pairs.\n\n* Lightweight, detailed reporting on specific state variables after simulation.\n\n* Developing synaptic plasticity rules.\n\n* Validating dynamics of synaptic properties.\n\n* Automating in-silico whole-cell patching experiments.\n\n* Debugging, both scientifically and computationally.\n\nCitation\n========\n\nWhen you use this BlueCelluLab software for your research, we ask you to cite the following reference(this includes poster presentations):\n\n.. code-block::\n\n @software{bluecellulab_zenodo,\n author = {Van Geit, Werner and Tuncel, Anil and Gevaert, Mike and Torben-Nielsen, Benjamin and Muller, Eilif},\n title = {BlueCelluLab},\n month = jul,\n year = 2023,\n publisher = {Zenodo},\n doi = {10.5281/zenodo.8113483},\n url = {https://doi.org/10.5281/zenodo.8113483}\n }\n\nSupport\n=======\n\nWe are providing support on `Gitter <https://gitter.im/BlueBrain/BlueCelluLab>`_. We suggest you create tickets on the `Github issue tracker <https://github.com/BlueBrain/BlueCelluLab/issues>`_ in case you encounter problems while using the software or if you have some suggestions.\n\nMain dependencies\n=================\n\n* `Python 3.8+ <https://www.python.org/downloads/release/python-380/>`_\n* `Neuron 8.0.2+ <https://pypi.org/project/NEURON/>`_\n\nInstallation\n============\n\nBlueCelluLab can be pip installed with the following command:\n\n.. code-block:: python\n\n pip install bluecellulab\n\nQuick Start\n===========\n\nThe following example shows how to create a cell, add a stimulus and run a simulation:\n\n.. code-block:: python\n\n from bluecellulab.cell import create_ball_stick\n from bluecellulab import Simulation\n\n cell = create_ball_stick()\n sim = Simulation()\n sim.add_cell(cell)\n stimulus = cell.add_step(start_time=5.0, stop_time=20.0, level=0.5)\n\n sim.run(25, cvode=False)\n time, voltage = cell.get_time(), cell.get_soma_voltage()\n # plotting time and voltage ...\n\n.. image:: https://raw.githubusercontent.com/BlueBrain/BlueCelluLab/main/docs/images/voltage-readme.png\n :alt: Voltage plot\n\nTutorial\n========\n\nA more detailed explanation on how to use BlueCelluLab, as well as other examples can be found on the `examples page <https://github.com/BlueBrain/BlueCelluLab/blob/main/examples/README.rst>`_.\n\nAPI Documentation\n=================\n\nThe API documentation can be found on `ReadTheDocs <https://bluecellulab.readthedocs.io>`_.\n\nRunning the tests\n=================\n\nTesting is set up using `tox`:\n\n.. code-block:: bash\n\n pip install tox\n\n tox -e py3 # runs the tests\n tox -e lint # runs the format checks\n\nFunding & Acknowledgements\n==========================\n\nThe development and maintenance of this code is supported by funding to the Blue Brain Project, a research center of the \u00c9cole polytechnique f\u00e9d\u00e9rale de Lausanne (EPFL), from the Swiss government's ETH Board of the Swiss Federal Institutes of Technology.\n\nCopyright\n=========\n\nCopyright (c) 2023 Blue Brain Project/EPFL\n\nThis work is licensed under `Apache 2.0 <https://www.apache.org/licenses/LICENSE-2.0.html>`_\n\nFor MOD files for which the original source is available on ModelDB, any specific licenses on mentioned on ModelDB, or the generic License of ModelDB apply.\n\nThe licenses of the morphology files used in this repository are available on: https://zenodo.org/record/5909613\n\n\n.. |license| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg\n :target: https://github.com/BlueBrain/BlueCelluLab/blob/main/LICENSE\n\n.. |tests| image:: https://github.com/BlueBrain/BlueCelluLab/actions/workflows/test.yml/badge.svg?branch=main\n :target: https://github.com/BlueBrain/BlueCelluLab/actions/workflows/test.yml\n :alt: CI\n\n.. |pypi| image:: https://img.shields.io/pypi/v/bluecellulab.svg\n :target: https://pypi.org/project/bluecellulab/\n :alt: latest release\n\n.. |docs| image:: https://readthedocs.org/projects/bluecellulab/badge/?version=latest\n :target: https://bluecellulab.readthedocs.io/\n :alt: latest documentation\n\n.. |coverage| image:: https://codecov.io/github/BlueBrain/BlueCelluLab/coverage.svg?branch=main\n :target: https://codecov.io/gh/BlueBrain/bluecellulab\n :alt: coverage\n\n.. |gitter| image:: https://badges.gitter.im/Join%20Chat.svg\n :target: https://gitter.im/BlueBrain/BlueCelluLab\n :alt: Join the chat at https://gitter.im/BlueBrain/BlueCelluLab\n\n.. |zenodo| image:: https://zenodo.org/badge/640805129.svg\n :target: https://zenodo.org/badge/latestdoi/640805129\n\n..\n The following image is also defined in the index.rst file, as the relative path is\n different, depending from where it is sourced.\n The following location is used for the github README\n The index.rst location is used for the docs README; index.rst also defined an end-marker,\n to skip content after the marker 'substitutions'.\n\n.. substitutions\n.. |banner| image:: https://raw.githubusercontent.com/BlueBrain/BlueCelluLab/main/docs/source/logo/BlueCelluLabBanner.jpg\n",
"bugtrack_url": null,
"license": "Apache2.0",
"summary": "Biologically detailed neural network simulations and analysis.",
"version": "2.6.13",
"project_urls": {
"Documentation": "https://bluecellulab.readthedocs.io/",
"Homepage": "https://github.com/BlueBrain/BlueCelluLab"
},
"split_keywords": [
"computational neuroscience",
" simulation",
" analysis",
" sonata",
" neural networks",
" neuron",
" blue brain project"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "4870b9d913298f346eb38c5be8008427497c9386dab67047ae8a52b7fb4b0089",
"md5": "572f511043d1c4280a5af5069c044133",
"sha256": "4da866179ef0b0913826defd71917d9d4edbba355b3a7321e35af62d099eb54d"
},
"downloads": -1,
"filename": "bluecellulab-2.6.13-py3-none-any.whl",
"has_sig": false,
"md5_digest": "572f511043d1c4280a5af5069c044133",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 119298,
"upload_time": "2024-05-08T11:29:53",
"upload_time_iso_8601": "2024-05-08T11:29:53.871136Z",
"url": "https://files.pythonhosted.org/packages/48/70/b9d913298f346eb38c5be8008427497c9386dab67047ae8a52b7fb4b0089/bluecellulab-2.6.13-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8505d1d49c4ec8bc37e1f2e9320b660a9b059ab0ca5eb9e0ca443d978ff31c7c",
"md5": "dc9ac5cc1655267794f36890f6685ffc",
"sha256": "cda16776eec183251321ddcb13e11ff81d7bfcc68ad7b2ecac870474081fdab7"
},
"downloads": -1,
"filename": "bluecellulab-2.6.13.tar.gz",
"has_sig": false,
"md5_digest": "dc9ac5cc1655267794f36890f6685ffc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 502878,
"upload_time": "2024-05-08T11:29:58",
"upload_time_iso_8601": "2024-05-08T11:29:58.250856Z",
"url": "https://files.pythonhosted.org/packages/85/05/d1d49c4ec8bc37e1f2e9320b660a9b059ab0ca5eb9e0ca443d978ff31c7c/bluecellulab-2.6.13.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-08 11:29:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BlueBrain",
"github_project": "BlueCelluLab",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "bluecellulab"
}