Download BrainWeb MRI data
Project description
Brainweb-DL
Welcome to Brainweb-DL, a powerful Python toolkit for downloading and converting the Brainweb dataset.
Features
-
Effortless Dataset Management: Automatically download, cache, and format the Brainweb dataset with ease. Convert it to the convenient nifti format or numpy array hassle-free.
-
Multiple Image Generation: Generate high-quality T1, T2, T2*, and PD images directly from the Brainweb dataset. Perfect for testing purposes, although keep in mind that the values provided are approximate.
Get Started
Data Location
The cached data directory follows this priority order:
- User-specific argument (
brainweb_dir
in most functions) BRAINWEB_DIR
environment variable~/.cache/brainweb
folder
Python Script Usage
from brainweb_dl import get_mri
data = get_mri(subject=44, contrast="T1")
The Brainweb dataset is downloaded and cached by default in the ~/.cache/brainweb
folder.
Command Line Interface
$ brainweb-dl 44 --contrast=T1
For more information, see brainweb-dl --help
.
Installation
Get up and running quickly!
$ pip install brainweb-dl
Development
Join our community and contribute to Brainweb-DL!
$ git clone git@github.com/paquiteau/brainweb-dl
$ cd brainweb-dl
$ pip install -e .[dev,test,doc]
TODO List
Help us improve and shape the future of Brainweb-DL:
- Add unit tests.
- Implement fuzzy search and multiple subjects download in parallel.
- Introduce an interface to download as BIDS format.
- Develop an interface to generate T1, T2, T2*, and PD images.
- Enhance the search for the location of the Brainweb dataset (User > Environment Variable > Default Location).
Acknowledgement
We extend our gratitude to the following for their contributions:
-
Casper De Clercq for the preliminary work and original idea. Check out his great work if you are interested in PET imaging and registration functionalities.
-
BrainWeb for providing this valuable dataset to the community.
:star2: If you like this work, don't forget to star it and share it 🌟
Project details
Release history Release notifications | RSS feed
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
Hashes for brainweb_dl-0.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 358bc8c2777007d9b0ede4c2ed4cf2e081acd7a1fcf2b7c839ee5726cbb7b2ff |
|
MD5 | e780ab60da48cbb62aa117905339af0d |
|
BLAKE2b-256 | a696ad52809fd4e4bf4d9986df71ec32d6c4919bbf4a71b34bea4663a1f8741a |