brainrender
A user-friendly python library to create high-quality, 3D neuro-anatomical renderings combining data from publicly available brain atlases with user-generated experimental data.
From: Claudi et al. (2021) Visualizing anatomically registered data with brainrender. eLife
Documentation
brainrender is a project of the BrainGlobe Initiative, which is a collaborative effort to develop a suite of Python-based software tools for computational neuroanatomy. A comprehensive online documentation for brainrender can be found on the BrainGlobe website here.
Furthermore, an open-access journal article describing BrainRender has been published in eLife, available here.
Installation
From PyPI:
pip install brainrender
Quickstart
import random
import numpy as np
from brainrender import Scene
from brainrender.actors import Points
def get_n_random_points_in_region(region, N):
"""
Gets N random points inside (or on the surface) of a mesh
"""
region_bounds = region.mesh.bounds()
X = np.random.randint(region_bounds[0], region_bounds[1], size=10000)
Y = np.random.randint(region_bounds[2], region_bounds[3], size=10000)
Z = np.random.randint(region_bounds[4], region_bounds[5], size=10000)
pts = [[x, y, z] for x, y, z in zip(X, Y, Z)]
ipts = region.mesh.inside_points(pts).coordinates
return np.vstack(random.choices(ipts, k=N))
# Display the Allen Brain mouse atlas.
scene = Scene(atlas_name="allen_mouse_25um", title="Cells in primary visual cortex")
# Display a brain region
primary_visual = scene.add_brain_region("VISp", alpha=0.2)
# Get a numpy array with (fake) coordinates of some labelled cells
coordinates = get_n_random_points_in_region(primary_visual, 2000)
# Create a Points actor
cells = Points(coordinates)
# Add to scene
scene.add(cells)
# Add label to the brain region
scene.add_label(primary_visual, "Primary visual cortex")
# Display the figure.
scene.render()
Seeking help or contributing
We are always happy to help users of our tools, and welcome any contributions. If you would like to get in contact with us for any reason, please see the contact page of our website.
Citing brainrender
If you use brainrender in your scientific work, please cite:
Claudi, F., Tyson, A. L., Petrucco, L., Margrie, T.W., Portugues, R., Branco, T. (2021) "Visualizing anatomically registered data with Brainrender" <i>eLife</i> 2021;10:e65751 [doi.org/10.7554/eLife.65751](https://doi.org/10.7554/eLife.65751)
BibTeX:
@article{Claudi2021,
author = {Claudi, Federico and Tyson, Adam L. and Petrucco, Luigi and Margrie, Troy W. and Portugues, Ruben and Branco, Tiago},
doi = {10.7554/eLife.65751},
issn = {2050084X},
journal = {eLife},
pages = {1--16},
pmid = {33739286},
title = {{Visualizing anatomically registered data with brainrender}},
volume = {10},
year = {2021}
}
3 maintainers
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file brainrender-2.2.0.tar.gz.
File metadata
- Download URL: brainrender-2.2.0.tar.gz
- Upload date:
- Size: 44.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f665dc1163f307c8b4c144f8bdcdd2ede4b159541f21c04ff1335a60fa543fcd
|
|
| MD5 |
37ff881a9c844009b585f71d26fa7ebe
|
|
| BLAKE2b-256 |
39e3f45d3b46fa9570ba4dc2d8fefa3322d718f4d3f584f4874df18e5a2ad955
|
File details
Details for the file brainrender-2.2.0-py3-none-any.whl.
File metadata
- Download URL: brainrender-2.2.0-py3-none-any.whl
- Upload date:
- Size: 48.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
cb0e0262c0c0e6607d8c4570349e85b7e6aee21a45a6feff218566872b6a982f
|
|
| MD5 |
5d712b6c59d579884461bd7ccb485965
|
|
| BLAKE2b-256 |
48e724679d9877157f887be08b4d5082fd001c300efde813d2d0d42f4670a5bf
|
