SynthBA: Reliable Brain Age Estimation Across Multiple MRI Sequences and Resolutions
Project description
SynthBA: Reliable Brain Age Estimation Across Multiple MRI Sequences and Resolutions
Arxiv • Usage • Installation • Cite
[!NOTE]
SynthBA has been peer-reviewed and accepted at IEEE MetroXRAINE 2024.
NEWS
- 🆕 Added support for providing inputs via a text file in non-Docker mode
- 🆕 Added the
--skip-prepflag to allow skipping preprocessing - 🆕 SynthBA is now available on DockerHub
Short description
SynthBA (Synthetic Brain Age) is a deep-learning model able to predict the biological age of the brain (referred to as brain age) through brain MRIs of arbitrary contrast and resolution. It follows the idea of using domain-randomization from the seminal work of SynthSeg.
Usage
Running SynthBA requires docker (see the Docker installation page) and nothing else. Once docker is installed, you can run the latest version of SynthBA (see DockerHub) in one command:
./synthba --help
Place your MRIs (nifti format) in a folder (/path/to/inputs) and create a folder where to store the outputs (/path/to/outputs). Then run:
./synthba /path/to/inputs /path/to/outputs \
-m <MODEL> -b <BATCHSIZE> -t <TEMPLATE>
Or directly using Docker:
docker run --rm \
-v /path/to/inputs:/home/inputs \
-v /path/to/outputs:/home/outputs \
lemuelpuglisi/synthba:latest \
-m <MODEL> -b <BATCHSIZE> -t <TEMPLATE>
Configure the batch size according to your available RAM. Templates are currently needed to align the scans to MNI space. We provide T1w and T2w templates, which should work for a wide range of MRI sequences. A list of <MODEL> and <TEMPLATE> options are provided below:
| MODEL | Description | TEMPLATE | Description |
|---|---|---|---|
g |
SynthBA-g | T1w_1mm |
T1w 1mm brain MNI152 template |
u |
SynthBA-u | T1w_2mm |
T1w 2mm brain MNI152 template |
T2w_1mm |
T2w 1mm brain MNI152 template |
The output folder will contain both the predicted brain age for each input (predictions.csv) and the preprocessed scans (in preprocessed).
[!WARNING]
Before running SynthBA on your MRIs, you might need to manually increase the RAM limit applied to Docker containers from Docker Desktop (see here).
Installation (Docker)
If you want to build the SynthBA's Docker image locally, run the following command at the root of the project:
docker build -t synthba .
Verify the installation by calling the --help option:
docker run --rm synthba --help
Citing
Cite the preprint:
@misc{puglisi2024synthba,
title={SynthBA: Reliable Brain Age Estimation Across Multiple MRI Sequences and Resolutions},
author={Lemuel Puglisi and Alessia Rondinella and Linda De Meo and Francesco Guarnera and Sebastiano Battiato and Daniele Ravì},
year={2024},
eprint={2406.00365},
archivePrefix={arXiv},
primaryClass={eess.IV}
}
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
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 synthba-0.0.0.tar.gz.
File metadata
- Download URL: synthba-0.0.0.tar.gz
- Upload date:
- Size: 12.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
32babea742e462ed9a7b48df97bea7c2b960737f46073450193c9bc01dfedfdb
|
|
| MD5 |
cdb0715945f4afee03915de477b21a96
|
|
| BLAKE2b-256 |
1c7114cb4de95414191a84eaff3463e1de378bdf826fcc2d1d74a5478c2cacff
|
File details
Details for the file synthba-0.0.0-py3-none-any.whl.
File metadata
- Download URL: synthba-0.0.0-py3-none-any.whl
- Upload date:
- Size: 12.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
653c9fa4c03bfabaf2b79d86be05a033a5ad68fed938ac8e600e25db21ead34a
|
|
| MD5 |
2bab37df48396e90b79f948d9d6eb938
|
|
| BLAKE2b-256 |
2dbf5358a64a0f649cfb21dc5405ee568c7013f03ed182f7a3c6a330adc5a364
|