aibl-to-bids
– Conversion of the Australian Imaging, Biomarker & Lifestyle Flagship Study of Ageing (AIBL) to BIDS¶
Description reproduced from the AIBL's Study Design webpage
The Australian Imaging, Biomarker & Lifestyle Flagship Study of Ageing (AIBL) seeks to discover which biomarkers, cognitive characteristics, and health and lifestyle factors determine the development of AD. Although AIBL and ADNI have many of the same goals, there are differences between the two projects. Read more about the AIBL study from their website.
Study Participants AIBL has enrolled 1100 participants and collected over 4.5 years worth of longitudinal data:
- 211 AD patients
- 133 MCI patients
- 768 comparable healthy controls
Data AIBL follows ADNI 1 protocols. Available data includes:
- Clinical and cognitive data
- Image data: MRI, PET
- Biomarkers data: blood, genotype, ApoE
- Dietary/lifestyle assessment
Dependencies¶
If you only installed the core of Clinica, this pipeline needs the installation of the dcm2niix DICOM to NIfTI converter.
Downloading AIBL¶
To download the AIBL dataset you first need to register to the LONI Image & Data Archive (IDA), a secure research data repository, and then request access to the AIBL dataset through the submission of an online application form.
In order to use the converter, you will need to download both the images and the clinical data.
To do so, from the main page click on PROJECTS
and AIBL
.
To download the imaging data, click on Download
and choose Image collections
.
In the Advanced search
tab, pick the images you wish to download, for example tick MRI
to download all the MR images, and then click on SEARCH
.
In the Advanced search results
tab, click Select All
and Add To Collection
.
Finally, in the Data Collection
tab, select the collection you just created, tick All
and click on Advanced download
.
We advise you to group files as 10 zip files.
To download the clinical data, from the main page of the AIBL project, click on Download Clinical Data
and on the next page click on DOWNLOAD
.
Note
You do not have to modify the original folder name or rename the clinical data files before using the converter.
Modalities supported¶
Currently, the modalities supported by our converter are:
- T1-weighted MRI
- Pittsburgh compound B (PiB) PET
- Florbetapir (AV45) PET
- Flutemetamol (FLUTE) PET
- Clinical data
The conversion of the imaging data to BIDS relies on modality-specific csv files that provide the list of scans available. For each AIBL participant, the only T1w MR, PiB PET, Florbetapir PET, and Flutemetamol PET image available per session is converted. For each image, the coordinates of the origin are set to the center of the box containing the image data. This allows other image processing pipelines in Clinica (mainly SPM based) to run without needing further image preprocessing.
The conversion of the clinical data relies on the list of subjects and sessions obtained after the conversion of the imaging data and on the csv files containing the non-imaging data.
Data that do not change over time are gathered in the participants.tsv
file, located at the top of the BIDS folder hierarchy, while the session-dependent data are gathered in <subjectID>_session.tsv
files in each participant subfolder.
The clinical data being converted are defined in a spreadsheet (clinical_specifications.xlsx
) available with the code of the converter, which the user can modify.
Using the converter¶
The converter can be run with the following command line:
clinica convert aibl-to-bids [OPTIONS] DATASET_DIRECTORY CLINICAL_DATA_DIRECTORY BIDS_DIRECTORY
where:
DATASET_DIRECTORY
is the path to the original AIBL images' directory;CLINICAL_DATA_DIRECTORY
is the path to the directory where the csv file with the clinical data is located;BIDS_DIRECTORY
is the path to the output directory, where the BIDS-converted version of AIBL will be stored.
Citing this converter in your paper¶
Example of paragraph:
The AIBL data have been curated and converted to the Brain Imaging Data Structure (BIDS) format [Gorgolewski et al., 2016] using Clinica [Routier et al., 2021; Samper-González et al., 2018].
Tip
Easily access the papers cited on this page on Zotero.
Contact us !¶
- Check for past answers on Clinica Google Group
- Start a discussion on GitHub
- Report an issue on Github