| Name | Cerebro-Viewer JSON |
| Version |
0.0.10.5
JSON |
| download |
| home_page | None |
| Summary | Cerebro Viewer - A pythonic 3D viewer to visualize and plot brains |
| upload_time | 2024-07-29 11:23:44 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.7 |
| license | None |
| keywords |
3d
brain viewer
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Cerebro_Viewer
A pythonic 3D viewer to visualize and plot brains and neuroimaging data
---
## Citing Cerebro:
Thanks for choosing Cerebro! We're honored to have you as a user. If you end up using our code in your project or research (which we hope you will!), we'd be grateful if you could give us a little shout-out by including the citation in your publication. This helps us spread the word, motivates us to keep making Cerebro better, and gives us warm and fuzzy feelings inside! 😊 Here's the reference you can use to site the package:
Sina Mansour L. (2023). Cerebro_Viewer A Pythonic 3D viewer to visualize and plot brains (v0.0.9). Zenodo. https://doi.org/10.5281/zenodo.7885669
[](https://doi.org/10.5281/zenodo.7885669)
Cerebro is a work in progress, and we're excited to share more with you soon! We're working on a manuscript that will showcase Cerebro's capabilities. Once that's published, appropriate references will be added here.
---
Cerebro aims to provide a solution to advance the currently available methods for visualization of neuroimaging and brain connectivity data.
## Installation
[Cerebro](https://pypi.org/project/Cerebro-Viewer/) is provided as a python package and requires Python 3. To install the latest Cerebro release, simply run the following command:
`pip install Cerebro-Viewer --upgrade`
---
## Motivation
Were you ever stuck when trying to visualize your study findings? Did you want to visualize different data formats and notice there’s no software to visualize them ALL in one place? Have you thought about a different way to present your findings but couldn’t find a tool to do it? Have you ever wondered if it would be possible to provide reproducible neuroimaging visualizations along your publications? Do you find limitations in current neuroimaging visualization software? And finally, did you ever want to generate nice brain visualizations within your script (without launching third-party software) and found the existing packages incapable/slow? Cerebro aims to provide a solution that tries to answer these needs.
---
## Development plan
Cerebro is currently under active development. The plan is to further develop exciting features through open-source contributions and discussions during hackathons, brainhacks, and other relevant opportunities. Checkout the [contributors page](Contributors.md) to find out more.
If you are looking for a visualization that is currently missing from Cerebro, please open a new issue to suggest the development of that feature.
---
To try the package, you could check out a range of [notebooks](https://cerebro-viewer.readthedocs.io/en/latest/notebook_examples/readme.html) and [example scripts](https://cerebro-viewer.readthedocs.io/en/latest/auto_examples/index.html) that showcase Cerebro's capabilities.
After installation, you may alternatively run the following code (inside python) to get Cerebro's visualizations in an interactive GUI:
```python
from cerebro import cerebro_brain_utils as cbu
from cerebro import cerebro_brain_viewer as cbv
my_brain_viewer = cbv.Cerebro_brain_viewer()
# render a surface
surface = 'pial'
surface_model = my_brain_viewer.load_template_GIFTI_cortical_surface_models(surface)
cifti_space = my_brain_viewer.visualize_cifti_space()
# render data over surface
dscalar_file = cbu.get_data_file(f'templates/HCP/dscalars/hcp.gradients.dscalar.nii')
dscalar_layer = my_brain_viewer.add_cifti_dscalar_layer(dscalar_file=dscalar_file,)
# enter interactive view
my_brain_viewer.show()
```
Raw data
{
"_id": null,
"home_page": null,
"name": "Cerebro-Viewer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "3D, Brain Viewer",
"author": null,
"author_email": "\"Sina Mansour L.\" <sina.mansour.lakouraj@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2f/b7/68700ceca2db7a1a32e4fc75f7ef78f1cd87756aa2eebc19139f322d2ee7/cerebro_viewer-0.0.10.5.tar.gz",
"platform": null,
"description": "# Cerebro_Viewer\nA pythonic 3D viewer to visualize and plot brains and neuroimaging data\n\n\n\n---\n\n## Citing Cerebro:\n\nThanks for choosing Cerebro! We're honored to have you as a user. If you end up using our code in your project or research (which we hope you will!), we'd be grateful if you could give us a little shout-out by including the citation in your publication. This helps us spread the word, motivates us to keep making Cerebro better, and gives us warm and fuzzy feelings inside! \ud83d\ude0a Here's the reference you can use to site the package:\n\nSina Mansour L. (2023). Cerebro_Viewer A Pythonic 3D viewer to visualize and plot brains (v0.0.9). Zenodo. https://doi.org/10.5281/zenodo.7885669\n\n[](https://doi.org/10.5281/zenodo.7885669)\n\nCerebro is a work in progress, and we're excited to share more with you soon! We're working on a manuscript that will showcase Cerebro's capabilities. Once that's published, appropriate references will be added here.\n\n---\n\nCerebro aims to provide a solution to advance the currently available methods for visualization of neuroimaging and brain connectivity data.\n\n## Installation\n\n[Cerebro](https://pypi.org/project/Cerebro-Viewer/) is provided as a python package and requires Python 3. To install the latest Cerebro release, simply run the following command:\n\n`pip install Cerebro-Viewer --upgrade`\n\n---\n\n## Motivation\n\nWere you ever stuck when trying to visualize your study findings? Did you want to visualize different data formats and notice there\u2019s no software to visualize them ALL in one place? Have you thought about a different way to present your findings but couldn\u2019t find a tool to do it? Have you ever wondered if it would be possible to provide reproducible neuroimaging visualizations along your publications? Do you find limitations in current neuroimaging visualization software? And finally, did you ever want to generate nice brain visualizations within your script (without launching third-party software) and found the existing packages incapable/slow? Cerebro aims to provide a solution that tries to answer these needs.\n\n---\n\n## Development plan\n\nCerebro is currently under active development. The plan is to further develop exciting features through open-source contributions and discussions during hackathons, brainhacks, and other relevant opportunities. Checkout the [contributors page](Contributors.md) to find out more.\n\nIf you are looking for a visualization that is currently missing from Cerebro, please open a new issue to suggest the development of that feature.\n\n---\n\nTo try the package, you could check out a range of [notebooks](https://cerebro-viewer.readthedocs.io/en/latest/notebook_examples/readme.html) and [example scripts](https://cerebro-viewer.readthedocs.io/en/latest/auto_examples/index.html) that showcase Cerebro's capabilities.\n\nAfter installation, you may alternatively run the following code (inside python) to get Cerebro's visualizations in an interactive GUI:\n\n```python\nfrom cerebro import cerebro_brain_utils as cbu\nfrom cerebro import cerebro_brain_viewer as cbv\n\nmy_brain_viewer = cbv.Cerebro_brain_viewer()\n\n# render a surface\nsurface = 'pial'\nsurface_model = my_brain_viewer.load_template_GIFTI_cortical_surface_models(surface)\n\ncifti_space = my_brain_viewer.visualize_cifti_space()\n\n# render data over surface\ndscalar_file = cbu.get_data_file(f'templates/HCP/dscalars/hcp.gradients.dscalar.nii')\ndscalar_layer = my_brain_viewer.add_cifti_dscalar_layer(dscalar_file=dscalar_file,)\n\n# enter interactive view\nmy_brain_viewer.show()\n\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Cerebro Viewer - A pythonic 3D viewer to visualize and plot brains",
"version": "0.0.10.5",
"project_urls": {
"Bug Tracker": "https://github.com/sina-mansour/Cerebro_Viewer/issues",
"Documentations": "https://cerebro-viewer.readthedocs.io",
"Homepage": "https://github.com/sina-mansour/Cerebro_Viewer"
},
"split_keywords": [
"3d",
" brain viewer"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8c6454b1d1f0fdfe921184c7b6e91a83abc322907a6911dc17d446bb9c1b15e9",
"md5": "956d9e3cca6080e645efb4b8963e872c",
"sha256": "81a17b26abd1cf680aeeb3f934186cddba8b7f3a2cd3a26428bfa92d85bd2eb3"
},
"downloads": -1,
"filename": "Cerebro_Viewer-0.0.10.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "956d9e3cca6080e645efb4b8963e872c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 14255242,
"upload_time": "2024-07-29T11:23:41",
"upload_time_iso_8601": "2024-07-29T11:23:41.270514Z",
"url": "https://files.pythonhosted.org/packages/8c/64/54b1d1f0fdfe921184c7b6e91a83abc322907a6911dc17d446bb9c1b15e9/Cerebro_Viewer-0.0.10.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "2fb768700ceca2db7a1a32e4fc75f7ef78f1cd87756aa2eebc19139f322d2ee7",
"md5": "1574af43b9519a81b7a6fe5d3e4f6ae3",
"sha256": "a8b86593c2d6221155fb557068224c93b66c088aba27deec8d678421cb44c037"
},
"downloads": -1,
"filename": "cerebro_viewer-0.0.10.5.tar.gz",
"has_sig": false,
"md5_digest": "1574af43b9519a81b7a6fe5d3e4f6ae3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 14134460,
"upload_time": "2024-07-29T11:23:44",
"upload_time_iso_8601": "2024-07-29T11:23:44.306176Z",
"url": "https://files.pythonhosted.org/packages/2f/b7/68700ceca2db7a1a32e4fc75f7ef78f1cd87756aa2eebc19139f322d2ee7/cerebro_viewer-0.0.10.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-29 11:23:44",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "sina-mansour",
"github_project": "Cerebro_Viewer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "cerebro-viewer"
}
