Creator: Jean-Philippe Fortin, firstname.lastname@example.org
Authors: Jean-Philippe Fortin, John Muschelli
If using the
EveTemplate package, please cite the following:
||Kenichi Oishi, Andreia V Faria and Susumu Mori, JHU-MNI-ss Atlas, 2010, Johns Hopkins University School of Medicine, Department of Radiology, Center for Brain Imaging Science||Link|
|WMPM||White Matter Parcellation Map||Oishi et al., Atlas-based whole brain white matter analysis using large deformation diffeomorphic metric mapping: Application to normal elderly and Alzheimer’s disease participants, Neuroimage, 2009||Link|
Complete BibTeX citations can be found here.
The JHU-MNI-ss atlas, which is often called “Eve Atlas”, is based on a single-subject data as described in Oishi et al, 2009. There are co-registered T1 (MPRAGE), T2, and DTI images as well as white matter parcellation map (WMPM). Once the image of interest is normalized to this atlas coordinate, the WMPM (which also includes gray matter structures) can be superimposed for anatomical definition (e.g. which structure is affected by a lesion or where exactly is the fMRI activation site) or automated segmentation.
EveTemplate package contains the anatomical T1 and T1 images, together with or without the skull on, as well as a brain mask. It also contains the three types of White Matter Parcellaton Map (WMPM) with the dictionary of the labels. Finally, we have performed a 3-tissue class segmentaiton with the FSL FAST algorithm and have included the segmentation classes in the package. For the MNI152 template, see the similar package MNITemplate.
We first load the package into R:
Once the package is loaded into R, use the command
readEve() to import the Eve template T1-w image as a
nifti object into R:
One can use the function
orthographic from the
oro.nifti package to visualize the template:
For the T2 image, T1 Brain only and Brain mask respectively, use the following:
eve_t2 <- readEve("T2") eve_t1_brain <- readEve("Brain") eve_brain_mask <- readEve("Brain_Mask")
To obtain the T2 image with the brain only, one can use the convolution of the T1 and brain mask as follows:
eve_t2_brain <- eve_t2*eve_brain_mask
In many preprocessing pipelines, the path of the template file in the system must be specified. For this, use the following:
eve_path <- getEvePath()
and similarly for the other images:
eve_t2_path <- getEvePath("T2") eve_t1_brain_path <- getEvePath("Brain") eve_brain_mask_path <- getEvePath("Brain_Mask")
We performed a 3-tissue class segmentation of the T1w Eve template using the FSL FAST segmentation algorithm via the
fslr package. The script that was used to perform the segmentation can be found here. The segmentation labels are 0 for Background (outside of the brain), 1 for cerebrospinal fluid (CSF), 2 for grey matter (GM) and 3 for white matter (WM). Let’s read the segmentation classes into R:
seg <- readEveSeg() orthographic(seg)
If one wishes to create a WM mask, could do the following:
wm_mask <- seg wm_mask[wm_mask!=3] <- 0
and similarly for the other tissues.
The Eve template comes with an atlas of the different anatomical structures of the brain (not only the White Matter structures, despite the name White Matter Parcellation Map). There are 3 different types of WMPM available.
For instance, to obtain the WMPM type I, the following command should be used:
map <- readEveMap(type="I")
The label dictionary can be loaded as a data frame into R using
labels <- getEveMapLabels(type="I")
|JHU_MNI_SS_TI.nii.gz||T1-w Eve Template||
|JHU_MNI_SS_T2.nii.gz||T2-w Eve Template||
|JHU_MNI_SS_Brain.nii.gz||T1-w Eve Template, skull stripped||
|JHU_MNI_SS_Brain_Mask.nii.gz||T1-w Eve Template, brain mask||
|JHU_MNI_SS_Brain_FAST_seg.nii.gz||FSL FAST tissue classes (1=CSF, 2=GM, 3=WM)||
|White Matter Parcellation Map:|
|JHU_MNI_SS_WMPM_Type-I.nii.gz||White Matter Parcellation Map (Type I)||
|JHU_MNI_SS_WMPM_Type-II.nii.gz||White Matter Parcellation Map (Type II)||
|JHU_MNI_SS_WMPM_Type-III.nii.gz||White Matter Parcellation Map (Type III)||
|eve_map_labels.rda||White Matter Parcellation Map labels (I)||
|eve_map_labels.rda||White Matter Parcellation Map labels (II)||
|eve_map_labels.rda||White Matter Parcellation Map labels (III)||
The GitHub repository https://github.com/muschellij2/Eve_Atlas from John Muschelli includes a useful discussion on how the Eve template compares to the MNI152 template and to the Rorden T1 image. The dimensions of the 3 templates do not agree, and different solutions are proposed to match the voxel locations, either by dropping slides, interpolating or performing a non-linear transformation. The files for the transformed templates are included in the repository.