Skip to main content

SynthBA: Reliable Brain Age Estimation Across Multiple MRI Sequences and Resolutions

Project description

synthba

SynthBA: Reliable Brain Age Estimation Across Multiple MRI Sequences and Resolutions

ArxivUsageInstallationCite

[!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-prep flag 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

synthba-0.0.0.tar.gz (12.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

synthba-0.0.0-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

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

Hashes for synthba-0.0.0.tar.gz
Algorithm Hash digest
SHA256 32babea742e462ed9a7b48df97bea7c2b960737f46073450193c9bc01dfedfdb
MD5 cdb0715945f4afee03915de477b21a96
BLAKE2b-256 1c7114cb4de95414191a84eaff3463e1de378bdf826fcc2d1d74a5478c2cacff

See more details on using hashes here.

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

Hashes for synthba-0.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 653c9fa4c03bfabaf2b79d86be05a033a5ad68fed938ac8e600e25db21ead34a
MD5 2bab37df48396e90b79f948d9d6eb938
BLAKE2b-256 2dbf5358a64a0f649cfb21dc5405ee568c7013f03ed182f7a3c6a330adc5a364

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page