# tvb-widgets
[](https://sonarcloud.io/summary/new_code?id=the-virtual-brain_tvb-widgets)
[](https://sonarcloud.io/summary/new_code?id=the-virtual-brain_tvb-widgets)
[](https://sonarcloud.io/summary/new_code?id=the-virtual-brain_tvb-widgets)
**TheVirtualBrain - Widgets** is a package with somehow generic GUI components,
but developed for **EBRAINS Showcases** in particular.
The showcases developed in the last phase of the HBP are meant to illustrate
the full potential of technical and scientific features offered by EBRAINS.
Access by the end users to this showcased functionality should be as easy as
possible. In order to support the usability of the showcases, as well as future
EBRAINS workflows, we develop here a set of modular graphic solutions which
can be easily deployed in the EBRAINS Collaboratory within the JupyterLab.
This module is also documented in EBRAINS here: https://wiki.ebrains.eu/bin/view/Collabs/tvb-widgets
These graphic user interface components enable:
1. Easy setup of models and region specific or cohort simulations. This includes single simulations as well as parameter explorations.
2. Selection of Data sources and their links to models. This will exploit the backend data access functionality to be developed new in TVB.
3. Integration of a subset of TVB analysis and visualisation tools.
4. The GUIs must be designed to be integrated into cells in the notebooks and Jupyter notebook extension for HPC resource usage and job tracking will be also developed as independent panels.
## Installation
This module is already available in EBRAINS lab,
but you can also make use of it locally, in which case, execute:
jupyter labextension install @jupyter-widgets/jupyterlab-manager
jupyter labextension install jupyter-matplotlib
pip install tvb-widgets
In order to install tvb-widgets from the local repo clone, directly in a notebook, run (in the first cell):
%pip install --quiet --upgrade pip
%pip install --quiet -e ..
%pip install tvb-data
For some of our widgets, where connection to EBRAINS storage is necessary,
you should setup as environment variable before launching the local Jupyter Lab instance:
export CLB_AUTH = "{Your TokenString copied from EBRAINS Collab}"
To retrieve the token string, execute in https://lab.ch.ebrains.eu/:
clb_oauth.get_token()
# Acknowledgments
This project has received funding from the European Union’s Horizon 2020 Framework Programme for Research and Innovation under the Specific Grant Agreement No. 945539 (Human Brain Project SGA3).
This project has received funding from the European Union’s Horizon Europe Programme under the Specific Grant Agreement No. 101147319 (EBRAINS 2.0 Project).
This projects also has contribution from @peeplika as part of Google Summer of Code, through INCF organization (https://summerofcode.withgoogle.com/programs/2024/organizations/incf).
Raw data
{
"_id": null,
"home_page": "https://github.com/the-virtual-brain/tvb-widgets",
"name": "tvb-widgets",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "tvb widgets jupyterlab ebrains showcases",
"author": "TVB Widgets Team (Juelich SDL Neuroscience, INS - Marseille, Codemart)",
"author_email": "tvb.admin@thevirtualbrain.org",
"download_url": "https://files.pythonhosted.org/packages/0d/4e/1711eacefa2dd3f1d0052a855ead155c70df3da3fff1463ad5e4c80a8902/tvb-widgets-2.1.0.tar.gz",
"platform": null,
"description": "# tvb-widgets\n \n[](https://sonarcloud.io/summary/new_code?id=the-virtual-brain_tvb-widgets)\n[](https://sonarcloud.io/summary/new_code?id=the-virtual-brain_tvb-widgets) \n[](https://sonarcloud.io/summary/new_code?id=the-virtual-brain_tvb-widgets)\n\n\n**TheVirtualBrain - Widgets** is a package with somehow generic GUI components, \nbut developed for **EBRAINS Showcases** in particular.\n\nThe showcases developed in the last phase of the HBP are meant to illustrate \nthe full potential of technical and scientific features offered by EBRAINS. \nAccess by the end users to this showcased functionality should be as easy as \npossible. In order to support the usability of the showcases, as well as future \nEBRAINS workflows, we develop here a set of modular graphic solutions which \ncan be easily deployed in the EBRAINS Collaboratory within the JupyterLab. \n\nThis module is also documented in EBRAINS here: https://wiki.ebrains.eu/bin/view/Collabs/tvb-widgets\n\nThese graphic user interface components enable:\n 1. Easy setup of models and region specific or cohort simulations. This includes single simulations as well as parameter explorations.\n 2. Selection of Data sources and their links to models. This will exploit the backend data access functionality to be developed new in TVB.\n 3. Integration of a subset of TVB analysis and visualisation tools.\n 4. The GUIs must be designed to be integrated into cells in the notebooks and Jupyter notebook extension for HPC resource usage and job tracking will be also developed as independent panels.\n\n## Installation\n\nThis module is already available in EBRAINS lab,\nbut you can also make use of it locally, in which case, execute:\n\n jupyter labextension install @jupyter-widgets/jupyterlab-manager\n jupyter labextension install jupyter-matplotlib\n pip install tvb-widgets\n\nIn order to install tvb-widgets from the local repo clone, directly in a notebook, run (in the first cell): \n\n %pip install --quiet --upgrade pip\n %pip install --quiet -e ..\n %pip install tvb-data\n\nFor some of our widgets, where connection to EBRAINS storage is necessary, \nyou should setup as environment variable before launching the local Jupyter Lab instance:\n\n export CLB_AUTH = \"{Your TokenString copied from EBRAINS Collab}\"\n\nTo retrieve the token string, execute in https://lab.ch.ebrains.eu/:\n\n clb_oauth.get_token()\n\n# Acknowledgments\nThis project has received funding 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\nThis project has received funding from the European Union\u2019s Horizon Europe Programme under the Specific Grant Agreement No. 101147319 (EBRAINS 2.0 Project).\n\nThis projects also has contribution from @peeplika as part of Google Summer of Code, through INCF organization (https://summerofcode.withgoogle.com/programs/2024/organizations/incf).\n\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "GUI widgets for EBRAINS showcases",
"version": "2.1.0",
"project_urls": {
"Homepage": "https://github.com/the-virtual-brain/tvb-widgets"
},
"split_keywords": [
"tvb",
"widgets",
"jupyterlab",
"ebrains",
"showcases"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "77d96bb1d66a5e24495f5e8c7c84cbe8736a781e9318fa846fcb2edff954d350",
"md5": "7ae5222c8dd8332eddaa8003a921f738",
"sha256": "d7f301baa405b84580a7b82e81a0b598e4adff401d616fe29bb015db897b14b5"
},
"downloads": -1,
"filename": "tvb_widgets-2.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7ae5222c8dd8332eddaa8003a921f738",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 114990,
"upload_time": "2024-09-24T09:39:56",
"upload_time_iso_8601": "2024-09-24T09:39:56.369314Z",
"url": "https://files.pythonhosted.org/packages/77/d9/6bb1d66a5e24495f5e8c7c84cbe8736a781e9318fa846fcb2edff954d350/tvb_widgets-2.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0d4e1711eacefa2dd3f1d0052a855ead155c70df3da3fff1463ad5e4c80a8902",
"md5": "eb2df3ee4d93152d0210ca00f3d1b359",
"sha256": "8d0cdd121045bd93fca1d71b7ffe8ce9421cf069388ad56d1e4ec1d09f31a8d7"
},
"downloads": -1,
"filename": "tvb-widgets-2.1.0.tar.gz",
"has_sig": false,
"md5_digest": "eb2df3ee4d93152d0210ca00f3d1b359",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 87711,
"upload_time": "2024-09-24T09:39:57",
"upload_time_iso_8601": "2024-09-24T09:39:57.970816Z",
"url": "https://files.pythonhosted.org/packages/0d/4e/1711eacefa2dd3f1d0052a855ead155c70df3da3fff1463ad5e4c80a8902/tvb-widgets-2.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-24 09:39:57",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "the-virtual-brain",
"github_project": "tvb-widgets",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "tvb-widgets"
}
JSON
