README.md 7.8 KB

tracking performed on the A0 component overlaid onto the tissue component ODFs

dHCP neonatal-multi-component-HARDI-atlas

This hosts the multi-component atlas of diffusion MRI data over the neonatal period created for the publication A framework for multi-component analysis of diffusion MRI data over the neonatal period. doi: 10.1016/j.neuroimage.2018.10.060 using data collected as part of the developing Human Connectome Project (dHCP).


Download

Manually

The weekly templates can be downloaded individually from here.

via the GIN command line interface

This describes how to download the data using the GIN-CLI client.

On macOS, it can be installed via homebrew:

brew tap g-node/pkg
brew install g-node/pkg/gin-cli

On ubuntu:

wget https://web.gin.g-node.org/G-Node/gin-cli-releases/raw/master/gin-cli-latest.deb
sudo dpkg -i gin-cli-latest.deb
sudo apt install -f

For standlone binaries and instructions for other operating systems, see here.

Then, to download this repository simply execute

gin get maxpietsch/dHCP_neonatal_HARDI_atlas
cd dHCP_neonatal_HARDI_atlas

Initially, place-holder files are downloaded instead of larger files (.git/annex). If you want to download all files use gin download --content, for individual files or directories use gin get-content <location>, for downloading all rigidly aligned templates use gin get-content v1/rigid/mean, check the download status with gin ls. See GIN CLI Usage Tutorial for details.

via Datalad

If needed, install datalad, then clone this repo with

datalad clone https://gin.g-node.org/maxpietsch/dHCP_neonatal_HARDI_atlas
cd dHCP_neonatal_HARDI_atlas

Finally, download any files needed. For instance, the group-average templates can be downloaded via datalad get v1/rigid/mean.

Data

Response functions and .mif.gz images can be processed, converted and inspected with MRtrix3 (https://www.mrtrix.org/).

Note that mean and median aggregation was perfomed using (Not-a-Number-) masked data using the brain masks as inclusion criteria for the aggregation operation. This prevents bias due to cropped data and allows retrospectively thresholding the template voxels by the number of subjects using the count.mif.gz images. For instance, the following MRtrix3 command replaces voxel values to which fewer than 5 subjects contribute by NaNs: mrcalc count.mif.gz 5 -ge odf_o_normed_cyo.mif.gz nan -if odf_o_normed_cyo_thresholded.mif.gz

Organisation

This repo is organised hierarchically:

├── LICENSE
├── README.md
└── v1                          <-- atlas version (`v1` is as used for the paper)
    ├── joint                   <-- jointly aligned data (single space across time)
    │   ├── mean                <-- mode of aggregation
    │   ├── median              <-- mode of aggregation
    │   ├── rois                <-- regions of interest used for the paper
    ├── rigid                   <-- weekly templates, rigidly aligned
    │   ├── mean
    │   └── median
    └── metadata                <-- subject information and response functions
        ├── rf_csf_all
        ├── rf_native
        ├── rf_tissue_32.9
        ├── rf_tissue_44.1
        ├── sub_ses_ga_32.9
        ├── sub_ses_ga_34.0
        ├── sub_ses_ga_35.2
        ├── sub_ses_ga_35.7
        ├── sub_ses_ga_37.1
        ├── sub_ses_ga_38.1
        ├── sub_ses_ga_39.1
        ├── sub_ses_ga_40.1
        ├── sub_ses_ga_40.9
        ├── sub_ses_ga_42.0
        ├── sub_ses_ga_42.8
        └── sub_ses_ga_44.1

The files (see fig. 3):


├── LICENSE
├── README.md
└── v1
    ├── joint
    │   ├── mean
    │   │   ├── 32.9
    │   │   │   ├── adc.mif.gz                         <-- DTI-fit, ADC map
    │   │   │   ├── count.mif.gz                       <-- sum across masks, useful to modify template mask
    │   │   │   ├── fa.mif.gz                          <-- DTI-fit, FA map
    │   │   │   ├── mask.mif.gz
    │   │   │   ├── odf_csf_normed_cyo.mif.gz          <-- fluid component ODF, intensity, normalised
    │   │   │   ├── odf_csf_normed_native.mif.gz       <-- subject-native fluid image
    │   │   │   ├── odf_o_normed_cyo.mif.gz            <-- Ao: older-appearing tissue component
    │   │   │   ├── odf_wm_gm_normed_native.mif.gz     <-- subject-native tissue image
    │   │   │   └── odf_y_normed_cyo.mif.gz            <-- Ay: younger-appearing tissue component, normalised
    │   │   ├── 34.0
...
    ├── metadata
    │   ├── rf_native                                   <-- subject-specific response functions
    │   │   ├── sub-CC00063AN06_ses-15102_36_csf.txt    <-- CSF response function for this subject (PMA: 36w)
    │   │   ├── sub-CC00063AN06_ses-15102_36_wm_gmi.txt
    │   │   ├── sub-CC00065XX08_ses-18600_41_csf.txt
    │   │   ├── sub-CC00065XX08_ses-18600_41_wm_gmi.txt
    │   │   ├── sub-CC00067XX10_ses-20200_40_csf.txt

...
    │   ├── rf_csf_all                                  <-- group-average response functions
    │   ├── rf_tissue_32.9
    │   ├── rf_tissue_44.1
    │   ├── sub_ses_ga_32.9                             <-- subject identitifers per age group
    │   ├── sub_ses_ga_34.0
    │   ├── sub_ses_ga_35.2
    │   ├── sub_ses_ga_35.7
    │   ├── sub_ses_ga_37.1
    │   ├── sub_ses_ga_38.1
    │   ├── sub_ses_ga_39.1
    │   ├── sub_ses_ga_40.1
    │   ├── sub_ses_ga_40.9
    │   ├── sub_ses_ga_42.0
    │   ├── sub_ses_ga_42.8
    │   └── sub_ses_ga_44.1
    └── rigid
        ├── mean
        │   ├── 32.9
        │   │   ├── adc.mif.gz
        │   │   ├── count.mif.gz
        │   │   ├── fa.mif.gz
        │   │   ├── mask.mif.gz
        │   │   ├── odf_csf_normed_cyo.mif.gz
        │   │   ├── odf_csf_normed_native.mif.gz
        │   │   ├── odf_o_normed_cyo.mif.gz
        │   │   ├── odf_wm_gm_normed_native.mif.gz
        │   │   └── odf_y_normed_cyo.mif.gz
        │   ├── 34.0
...

Cite

Please cite the following publication:

Pietsch, Maximilian, et al. "A framework for multi-component analysis of diffusion MRI data over the neonatal period." NeuroImage 186 (2019): 321-337.

@article{pietsch2019framework,
  title={A framework for multi-component analysis of diffusion MRI data over the neonatal period},
  author={Pietsch, Maximilian and Christiaens, Daan and Hutter, Jana and Cordero-Grande, Lucilio and Price, Anthony N and Hughes, Emer and Edwards, A David and Hajnal, Joseph V and Counsell, Serena J and Tournier, J-Donald},
  journal={NeuroImage},
  volume={186},
  pages={321--337},
  year={2019},
  publisher={Elsevier}
}