genfi-to-bids
– Conversion of the GENFI to BIDS¶
Description reproduced from the GENFI webpage
The Genetic Frontotemporal dementia Initiative (GENFI) is a group of research centres across Europe and Canada with expertise in familial FTD, and is co-ordinated by Professor Jonathan Rohrer at University College London. GENFI is the largest genetic FTD consortium to date and currently consists of sites across the UK, Netherlands, Belgium, France, Spain, Portugal, Italy, Germany, Sweden, Denmark, Finland and Canada. The aim of the study is to understand more about genetic FTD, particularly in those who have mutations in the progranulin (GRN), microtubule-associated protein tau (MAPT) and chromosome 9 open reading frame 72 (C9orf72) genes. GENFI investigates both people who have developed symptoms and also people who have a risk of developing symptoms in the future because they carry an abnormal genetic mutation. By studying these individuals who are destined to develop the disease later in life we can understand the development from the very earliest changes. The key objectives of GENFI are therefore to develop markers which help identify the disease at its earliest stage as well as markers that allow the progression of the disease to be tracked. We are now collaborating closely with other similar studies around the world through the FTD Prevention Initiative. Through this worldwide initiative we are working with pharmaceutical companies to help design clinical trials for genetic FTD.
Dependencies¶
If you only installed the core of Clinica, this pipeline needs the installation of the dcm2niix DICOM to NIfTI converter.
Supported modalities¶
Please note that this converter currently processes the following modalities :
- T1W
- T2W
- DWI
- Fieldmaps
- rsfMRI
Downloading GENFI¶
To download GENFI in a way that you can convert it, you need to make sure of two things: - Only select the "simplify downloaded archive structure" in download data options. - Select only "DICOM" in "Select Image Data" section "Scans Format".
Using the converter¶
The converter can be run with the following command line:
clinica convert genfi-to-bids [OPTIONS] DATASET_DIRECTORY BIDS_DIRECTORY
where:
-
DATASET_DIRECTORY
is the path to the original GENFI imaging directory, whose content should look like:DATASET_DIRECTORY ├── C9ORF001-01-MR00 │ ├── 1 │ ├── 11 │ ├── 12 │ └── 13 ├── C9ORF001-11 │ ├── 1 │ ├── 2 │ ├── 4 │ ├── 5 │ ├── 6 │ ├── 7 │ ├── 8 │ └── 9 └── GRN001-01-MR00 ├── 1 ├── 10 ├── 8 └── 9
-
BIDS_DIRECTORY
is the path to the output directory where the BIDS-converted version of GENFI will be stored. -
OPTIONS
:--clinical-data-dir/-cdd
is the path to the clinical data directory.--clinical-data-tsv/-cdt
is a tsv file containing the additional fields the user wants. The available data can be retrieved inside the installation of clincia at this locationyour_path_to_clinica/clinica/iotools/data/genfi_data.tsv
.-gif
Allows the user to add the value from gif to the session.tsv.
Note
In order to improve the readability, the BIDS subject ID is the genetic group concatenated with the original GENFI ID and is defined as follows:
sub-GRN/C9ORF/MAPT+ original numerical ID of the subject
Example
If the original subject ID is 0001
, the final BIDS ID will be sub-GRN0001
.
Citing this converter in your paper¶
Example of paragraph:
The GENFI data have been curated and converted to the Brain Imaging Data Structure (BIDS) format [Gorgolewski et al., 2016] using Clinica [Routier et al.; 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