oasis-to-bids – Conversion of the Open Access Series of Imaging Studies (OASIS) to BIDS¶
Description reproduced from the OASIS' webpage
The Open Access Series of Imaging Studies (OASIS) is a project aimed at making MRI data sets of the brain freely available to the scientific community. By compiling and freely distributing MRI data sets, we hope to facilitate future discoveries in basic and clinical neuroscience. OASIS is made available by the Washington University Alzheimer’s Disease Research Center, Dr. Randy Buckner at the Howard Hughes Medical Institute (HHMI) at Harvard University, the Neuroinformatics Research Group (NRG) at Washington University School of Medicine, and the Biomedical Informatics Research Network (BIRN).
The "Cross-sectional MRI Data in Young, Middle Aged, Nondemented and Demented Older Adults" set consists of a cross-sectional collection of 416 subjects aged 18 to 96. For each subject, 3 or 4 individual T1-weighted MRI scans obtained in single scan sessions are included. The subjects are all right-handed and include both men and women. 100 of the included subjects over the age of 60 have been clinically diagnosed with very mild to moderate Alzheimer’s disease (AD). Additionally, a reliability data set is included containing 20 nondemented subjects imaged on a subsequent visit within 90 days of their initial session.
For more information about the images and the dataset you can read the OASIS Fact Sheet.
If you installed the core of Clinica, this converter needs no further dependencies.
The OASIS to BIDS converter requires the user to have downloaded the OASIS-1 (also called Cross-sectional MRI Data in Young, Middle Aged, Nondemented and Demented Older Adults) imaging and clinical data. To do so, visit the OASIS website, click on
OASIS-1. You can download the imaging data via FTP or XNAT (if you click on
Browse Data). Download the clinical data by clicking on
You do not have to modify the original folder name or rename the clinical data file before using the converter.
We do not currently support the conversion of OASIS-2 and OASIS-3.
Currently, the converter converts only the T1-weighted MRI images and clinical data.
To convert the imaging data to BIDS, the list of subjects is obtained from the downloaded folders.
For each subject, among the multiple T1w MR images available, we select the average of the motion-corrected co-registered individual images resampled to 1 mm isotropic voxels, located in the
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 oasis-to-bids [OPTIONS] DATASET_DIRECTORY CLINICAL_DATA_DIRECTORY BIDS_DIRECTORY
DATASET_DIRECTORYis the path to the original OASIS images' directory. Its content looks like:
DATASET_DIRECTORY ├── OAS1_0001_MR1 │ ├── FSL_SEG │ ├── PROCESSED │ │ └── MPRAGE │ │ ├── SUBJ_111 │ │ └── T88_111 │ │ └── t4_files │ └── RAW ├── ...
CLINICAL_DATA_DIRECTORYis the path to the directory containing the CSV file called
BIDS_DIRECTORYis the path to the output directory, where the BIDS-converted version of OASIS will be stored.
In order to improve the readability, the BIDS subject ID is different from the original OASIS ID and is defined as follows:
sub-OASIS1+ original numerical ID of the subject
If the original subject ID is
OAS1_0001_MR1, since the numerical ID is
0001, the final BIDS ID will be
Citing this converter in your paper¶
Example of paragraph:
Easily access the papers cited on this page on Zotero.