Code Monkey home page Code Monkey logo

bluepyemodel's Introduction

banner

BluePyEModel: Blue Brain Python Electrical Modeling Pipeline

Latest Release latest release
Documentation latest documentation
License license
Build Status CI
Coverage coverage
Citation zenodo

Introduction

The Blue Brain Python Electrical Modeling Pipeline (BluePyEModel) is a Python package facilitating the configuration and execution of electrical neuron model (e-model) building tasks. It covers tasks such as extraction of electrical features from electrophysiology data, e-model parameters optimisation and model validation. As such, it builds on top of eFEL, BluePyEfe and BluePyOpt.

For a general overview and example of electrical model building, please refer to the paper: A universal workflow for creation, validation and generalization of detailed neuronal models.

Note that this package only covers e-model building based on patch-clamp data and that it relies solely on the NEURON simulator.

Citation

When you use the BluePyEModel software or method for your research, we ask you to cite the following publication (this includes poster presentations):

@software{bluepyemodel_zenodo,
  author       = {Damart, Tanguy and Jaquier, Aurélien and Arnaudon, Alexis and Mandge, Darshan and Van Geit, Werner and Kilic, Ilkan},
  title        = {BluePyEModel},
  month        = aug,
  year         = 2023,
  publisher    = {Zenodo},
  doi          = {8283490},
  url          = {https://doi.org/10.5281/zenodo.8283490}
}

Installation

BluePyEModel can be pip installed with the following command:

pip install bluepyemodel[all]

If you do not wish to install all dependencies, specific dependencies can be selected by indicating which ones to install between brackets in place of 'all' (If you want multiple dependencies, they have to be separated by commas). The available dependencies are:

  • luigi
  • all

To get started with the E-Model building pipeline

E-Model building pipeline

This section presents a general picture of the pipeline. For a detailed picture and how to use it, please refer to the example directory and its README.

The pipeline is divided in 6 steps:

  • extraction: extracts e-features from ephys recordings and averages the results e-feature values along the requested targets.
  • optimisation: builds a NEURON cell model and optimises its parameters using as targets the efeatures computed during e-feature extraction.
  • storage of the model: reads the results of the extraction and stores the models (best set of parameters) in a local json file.
  • validation: reads the models and runs the optimisation protocols and/or validation protocols on them. The e-feature scores obtained on these protocols are then passed to a validation function that decides if the model is good enough.
  • plotting: reads the models and runs the optimisation protocols and/or validation protocols on them. Then, plots the resulting traces along the e-feature scores and parameter distributions.
  • exporting: read the parameter of the best models and export them in files that can be used either in NEURON or for circuit building.

These six steps are to be run in order as for example validation cannot be run if no models have been stored. Steps "validation", "plotting" and "exporting" are optional. Step "extraction" can also be optional in the case where the file containing the protocols and optimisation targets is created by hand or if it is obtained from an older project.

Schematics of BluePyEModel classes

Schematics of BluePyEModel classes

Acknowledgment

This work was 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. This work has been partially funded by the European Union Seventh Framework Program (FP7/2007­2013) 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

Copyright (c) 2023 Blue Brain Project/EPFL

This work is licensed under Apache 2.0

bluepyemodel's People

Contributors

ilkilic avatar aurelienjaquier avatar darshanmandge avatar mgeplf avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.