|banner|
-----------------
BluePyEfe: Blue Brain Python E-feature extraction
=================================================
+----------------+------------+
| Latest Release | |pypi| |
+----------------+------------+
| Documentation | |docs| |
+----------------+------------+
| License | |license| |
+----------------+------------+
| Build Status | |tests| |
+----------------+------------+
| Coverage | |coverage| |
+----------------+------------+
| Citation | |zenodo| |
+----------------+------------+
| Gitter | |gitter| |
+----------------+------------+
Introduction
============
BluePyEfe aims at easing the process of reading experimental recordings and extracting
batches of electrical features from these recordings. To do so, it combines trace reading
functions and features extraction functions from the `eFel library <https://github.com/BlueBrain/eFEL>`_.
BluePyEfe outputs protocols and features files in the format used
by `BluePyOpt <https://github.com/BlueBrain/BluePyOpt>`_ for neuron electrical model building.
How to cite
===========
If you use this repository in your work, please refer to the "Cite this repository" button at the top of the repository page to get various citation formats, including APA and BibTeX.
For detailed citation information, please refer to the `CITATION.cff <./CITATION.cff>`_ file.
Requirements
============
* `Python 3.9+ <https://www.python.org/downloads/release/python-380/>`_
* `eFEL eFeature Extraction Library <https://github.com/BlueBrain/eFEL>`_ (automatically installed by pip)
* `Numpy <http://www.numpy.org>`_ (automatically installed by pip)
* `Scipy <https://www.scipy.org/>`_ (automatically installed by pip)
* `Neo <https://neo.readthedocs.io/en/stable/>`_ (automatically installed by pip)
* The instruction below are written assuming you have access to a command shell on Linux / UNIX / MacOSX / Cygwin
Installation
============
To install BluePyEfe, run:
.. code-block:: bash
pip install bluepyefe
Quick Start and Operating Principle
===================================
For a hands-on introduction to BluePyEfe, have a look at the notebook `examples/example_of_extraction.ipynb <examples/example_of_extraction.ipynb>`_
The goal of the present package is to extract meaningful electrophysiological features (e-features) from voltage time series.
The e-features considered in the present package are the one implemented in the `eFEL python library <https://github.com/BlueBrain/eFEL>`_. See `this pdf <https://bluebrain.github.io/eFEL/efeature-documentation.pdf>`_ for a list of available e-features.
The present package makes one major assumption: E-features are more meaningful if they are coming from a set of traces rather than a single trace. And they are even more meaningful if these traces come from different cells of the same cellular type.
This assumption dictates the organisation of the package and has several consequences:
The efeatures extracted through the package will always be averaged over the trace considered. For example, the AP_amplitude will be an average over all the action potentials present in a trace. If you wish to work on an AP by AP basis, please consider using the eFEL library directly.
A large part of the present software is therefore dedicated to averaging the features across set of "equivalent" recordings. To be able to average e-features across different cells in a meaningful way, an equivalence must be established between the traces coming from these different cells. It would not make sense to average the mean firing frequency obtain cell A on a 1s long step protocol with the one obtain for cell B on a ramp protocol that lasts for 500ms. We chose to define recordings as equivalent based on two criteria: (1) They have the same name and (2) they are of the same amplitude when the amplitude is expressed as a percentage of the rheobase of the cell.
A pseudo-code for the main function of the package (bluepyefe.extract.extract_efeatures) could look as follows:
#. Load the data to memory by reading all the files containing the traces
#. Extract the required e-features for all the traces
#. Compute the rheobases of the cells based on one or several protocols
#. Use these rheobases to associate to each protocol an amplitude expressed in % of the rheobase
#. Compute the mean and standard deviations for the e-features across traces having the same amplitude
#. Save the results and plot the traces and e-features
Each of these steps are parametrized by a number of settings, therefore we recommend that you read carefully the docstring of the function.
Coming from the legacy version
==============================
The legacy version (v0.4*) is moved to the legacy branch.
Changes introduced in v2.0.0 are listed in the `CHANGELOG.rst <CHANGELOG.rst>`_.
That is the only file you need to look at for the changes as the future changes will also be noted there.
Funding
=======
This work has been partially funded by the European Union Seventh Framework Program (FP7/20072013) under grant agreement no. 604102 (HBP), and by the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreements No. 720270 (Human Brain Project SGA1) and No. 785907 (Human Brain Project SGA2) and by the EBRAINS research infrastructure, funded from the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3).
Copyright (c) 2016-2024 Blue Brain Project/EPFL
.. |pypi| image:: https://img.shields.io/pypi/v/bluepyefe.svg
:target: https://pypi.org/project/bluepyefe/
:alt: latest release
.. |docs| image:: https://readthedocs.org/projects/bluepyefe/badge/?version=latest
:target: https://bluepyefe.readthedocs.io/
:alt: latest documentation
.. |license| image:: https://img.shields.io/pypi/l/bluepyefe.svg
:target: https://github.com/BlueBrain/bluepyefe/blob/master/LICENSE.txt
:alt: license
.. |tests| image:: https://github.com/BlueBrain/BluePyEfe/workflows/Build/badge.svg?branch=master
:target: https://github.com/BlueBrain/BluePyEfe/actions
:alt: Actions build status
.. |coverage| image:: https://codecov.io/github/BlueBrain/BluePyEfe/coverage.svg?branch=master
:target: https://codecov.io/gh/BlueBrain/BluePyEfe
:alt: coverage
.. |gitter| image:: https://badges.gitter.im/Join%20Chat.svg
:target: https://gitter.im/bluebrain/bluepyefe
:alt: gitter
.. |zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3728191.svg
:target: https://doi.org/10.5281/zenodo.3728191
:alt: DOI
..
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/BluePyEfe/master/docs/source/logo/BluePyEfeBanner.jpg
Raw data
{
"_id": null,
"home_page": null,
"name": "bluepyefe",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "neuroscience, BlueBrainProject",
"author": null,
"author_email": "\"Blue Brain Project, EPFL\" <werner.vangeit@epfl.ch>",
"download_url": "https://files.pythonhosted.org/packages/49/47/74cb4c727e042976308f71bebeb1b981d93d23acb04a889ec13350b1b7d3/bluepyefe-2.3.39.tar.gz",
"platform": null,
"description": "|banner|\n\n-----------------\n\nBluePyEfe: Blue Brain Python E-feature extraction\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| Citation | |zenodo| |\n+----------------+------------+\n| Gitter | |gitter| |\n+----------------+------------+\n\n\nIntroduction\n============\n\nBluePyEfe aims at easing the process of reading experimental recordings and extracting\nbatches of electrical features from these recordings. To do so, it combines trace reading\nfunctions and features extraction functions from the `eFel library <https://github.com/BlueBrain/eFEL>`_.\n\nBluePyEfe outputs protocols and features files in the format used\nby `BluePyOpt <https://github.com/BlueBrain/BluePyOpt>`_ for neuron electrical model building.\n\nHow to cite\n===========\nIf you use this repository in your work, please refer to the \"Cite this repository\" button at the top of the repository page to get various citation formats, including APA and BibTeX.\n\nFor detailed citation information, please refer to the `CITATION.cff <./CITATION.cff>`_ file.\n\nRequirements\n============\n\n* `Python 3.9+ <https://www.python.org/downloads/release/python-380/>`_\n* `eFEL eFeature Extraction Library <https://github.com/BlueBrain/eFEL>`_ (automatically installed by pip)\n* `Numpy <http://www.numpy.org>`_ (automatically installed by pip)\n* `Scipy <https://www.scipy.org/>`_ (automatically installed by pip)\n* `Neo <https://neo.readthedocs.io/en/stable/>`_ (automatically installed by pip)\n* The instruction below are written assuming you have access to a command shell on Linux / UNIX / MacOSX / Cygwin\n\nInstallation\n============\n\nTo install BluePyEfe, run:\n\n.. code-block:: bash\n\n pip install bluepyefe\n\n\nQuick Start and Operating Principle\n===================================\n\nFor a hands-on introduction to BluePyEfe, have a look at the notebook `examples/example_of_extraction.ipynb <examples/example_of_extraction.ipynb>`_\n\nThe goal of the present package is to extract meaningful electrophysiological features (e-features) from voltage time series.\nThe e-features considered in the present package are the one implemented in the `eFEL python library <https://github.com/BlueBrain/eFEL>`_. See `this pdf <https://bluebrain.github.io/eFEL/efeature-documentation.pdf>`_ for a list of available e-features.\n\nThe present package makes one major assumption: E-features are more meaningful if they are coming from a set of traces rather than a single trace. And they are even more meaningful if these traces come from different cells of the same cellular type.\nThis assumption dictates the organisation of the package and has several consequences:\n\nThe efeatures extracted through the package will always be averaged over the trace considered. For example, the AP_amplitude will be an average over all the action potentials present in a trace. If you wish to work on an AP by AP basis, please consider using the eFEL library directly.\n\nA large part of the present software is therefore dedicated to averaging the features across set of \"equivalent\" recordings. To be able to average e-features across different cells in a meaningful way, an equivalence must be established between the traces coming from these different cells. It would not make sense to average the mean firing frequency obtain cell A on a 1s long step protocol with the one obtain for cell B on a ramp protocol that lasts for 500ms. We chose to define recordings as equivalent based on two criteria: (1) They have the same name and (2) they are of the same amplitude when the amplitude is expressed as a percentage of the rheobase of the cell.\n\nA pseudo-code for the main function of the package (bluepyefe.extract.extract_efeatures) could look as follows:\n\n#. Load the data to memory by reading all the files containing the traces\n#. Extract the required e-features for all the traces\n#. Compute the rheobases of the cells based on one or several protocols\n#. Use these rheobases to associate to each protocol an amplitude expressed in % of the rheobase\n#. Compute the mean and standard deviations for the e-features across traces having the same amplitude\n#. Save the results and plot the traces and e-features\n\nEach of these steps are parametrized by a number of settings, therefore we recommend that you read carefully the docstring of the function.\n\nComing from the legacy version\n==============================\nThe legacy version (v0.4*) is moved to the legacy branch.\nChanges introduced in v2.0.0 are listed in the `CHANGELOG.rst <CHANGELOG.rst>`_.\nThat is the only file you need to look at for the changes as the future changes will also be noted there.\n\nFunding\n=======\nThis work has been partially funded by the European Union Seventh Framework Program (FP7/2007\u00ad2013) under grant agreement no. 604102 (HBP), and by the European Union\u2019s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreements No. 720270 (Human Brain Project SGA1) and No. 785907 (Human Brain Project SGA2) and by the EBRAINS research infrastructure, funded from the European Union\u2019s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3).\n\nCopyright (c) 2016-2024 Blue Brain Project/EPFL\n\n.. |pypi| image:: https://img.shields.io/pypi/v/bluepyefe.svg\n :target: https://pypi.org/project/bluepyefe/\n :alt: latest release\n.. |docs| image:: https://readthedocs.org/projects/bluepyefe/badge/?version=latest\n :target: https://bluepyefe.readthedocs.io/\n :alt: latest documentation\n.. |license| image:: https://img.shields.io/pypi/l/bluepyefe.svg\n :target: https://github.com/BlueBrain/bluepyefe/blob/master/LICENSE.txt\n :alt: license\n.. |tests| image:: https://github.com/BlueBrain/BluePyEfe/workflows/Build/badge.svg?branch=master\n :target: https://github.com/BlueBrain/BluePyEfe/actions\n :alt: Actions build status\n.. |coverage| image:: https://codecov.io/github/BlueBrain/BluePyEfe/coverage.svg?branch=master\n :target: https://codecov.io/gh/BlueBrain/BluePyEfe\n :alt: coverage\n.. |gitter| image:: https://badges.gitter.im/Join%20Chat.svg\n :target: https://gitter.im/bluebrain/bluepyefe\n :alt: gitter\n.. |zenodo| image:: https://zenodo.org/badge/DOI/10.5281/zenodo.3728191.svg\n :target: https://doi.org/10.5281/zenodo.3728191\n :alt: DOI\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/BluePyEfe/master/docs/source/logo/BluePyEfeBanner.jpg\n\n",
"bugtrack_url": null,
"license": "BluePyEfe - Bluebrain Python E-feature extraction Library BluePyEfe is licensed under the LGPL, unless noted otherwise, e.g., for external dependencies. See file LGPL.txt for the full license. Examples and test are BSD-licensed. External dependencies are either LGPL or BSD-licensed. See file AUTHORS.txt for further details. Copyright (C) 2005-2024, Blue Brain Project/EPFL. This program is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details. You should have received a copy of the GNU Lesser General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. ",
"summary": "Blue Brain Python E-feature extraction",
"version": "2.3.39",
"project_urls": {
"Documentation": "https://bluepyefe.readthedocs.io/en/latest",
"Homepage": "https://github.com/BlueBrain/BluePyEfe",
"Repository": "https://github.com/BlueBrain/BluePyEfe.git",
"Source": "https://github.com/BlueBrain/BluePyEfe",
"Tracker": "https://github.com/BlueBrain/BluePyEfe/issues"
},
"split_keywords": [
"neuroscience",
" bluebrainproject"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7726bae97433153c18545227d2c0af5fabbe5d93c453f86d93ac645ce4470a7e",
"md5": "d9e9809be0240d2c7c90542b2b63de4d",
"sha256": "05f450e1859f53e62006e43779595ac6e7906ac0614bfe4113dd9d2e074904b4"
},
"downloads": -1,
"filename": "bluepyefe-2.3.39-py3-none-any.whl",
"has_sig": false,
"md5_digest": "d9e9809be0240d2c7c90542b2b63de4d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 65216,
"upload_time": "2024-12-04T13:56:54",
"upload_time_iso_8601": "2024-12-04T13:56:54.034929Z",
"url": "https://files.pythonhosted.org/packages/77/26/bae97433153c18545227d2c0af5fabbe5d93c453f86d93ac645ce4470a7e/bluepyefe-2.3.39-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "494774cb4c727e042976308f71bebeb1b981d93d23acb04a889ec13350b1b7d3",
"md5": "068504c2d6ee268dc53a04d378c56a9b",
"sha256": "1de5f8835bb0145ba32bf90691e46457db06e007ba624c73eddf1c1a5bdbafd4"
},
"downloads": -1,
"filename": "bluepyefe-2.3.39.tar.gz",
"has_sig": false,
"md5_digest": "068504c2d6ee268dc53a04d378c56a9b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 1027773,
"upload_time": "2024-12-04T13:56:56",
"upload_time_iso_8601": "2024-12-04T13:56:56.018041Z",
"url": "https://files.pythonhosted.org/packages/49/47/74cb4c727e042976308f71bebeb1b981d93d23acb04a889ec13350b1b7d3/bluepyefe-2.3.39.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-12-04 13:56:56",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "BlueBrain",
"github_project": "BluePyEfe",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "bluepyefe"
}