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.1.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.1.0-py3-none-any.whl (12.5 kB view details)

Uploaded Python 3

File details

Details for the file synthba-0.1.0.tar.gz.

File metadata

  • Download URL: synthba-0.1.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.1.0.tar.gz
Algorithm Hash digest
SHA256 fc93cd3f3795a2e29491aaa4df4cd7ee90ba360ace2f579429d859a1e10dffbd
MD5 aebde6cffbb2d731c623a7107e9499ae
BLAKE2b-256 915826e3f039cd966f2f2a7da00243d179a0326adee91afc6ecfcd06ea5a36ae

See more details on using hashes here.

File details

Details for the file synthba-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: synthba-0.1.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.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4eca0b3f877878a8e59c148d4c28e3d5a82ba431cc80ad8c1574fa769995ba83
MD5 c97be6942e0728b99009ef861ac99b6c
BLAKE2b-256 b4f3d5ff5eb6aaf915430860eda49b2bce4204b307d199577e874a54d6458469

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