Difference between revisions of "Cerebellum CNN"
Jump to navigation
Jump to search
(Updated with the new publication.) |
|||
Line 1: | Line 1: | ||
− | <meta name="title" content="Cerebellum Parcellation with Convolutional Neural Networks"/> | + | <meta name="title" content="ACAPULCO: Cerebellum Parcellation with Convolutional Neural Networks"/> |
{{h2|Cerebellum Parcellation with Convolutional Neural Networks}} | {{h2|Cerebellum Parcellation with Convolutional Neural Networks}} | ||
{{TOCright}} | {{TOCright}} | ||
− | + | <u>A</u>utomatic <u>c</u>erebellum <u>a</u>natomical <u>p</u>arcellation using <u>U</u>-Net with <u>l</u>ocally <u>c</u>onstrained <u>o</u>ptimization (ACAPULCO) is our current cerebellum parcellation method. The associated publication is: | |
− | |||
+ | {{iacl-pub| author=S. Han, A. Carass, Y. He, and J.L. Prince| title=Automatic Cerebellum Anatomical Parcellation using U-Net with Locally Constrained Optimization| jrnl=ni| number=218:116819| when=2020| doi=10.1016/j.neuroimage.2020.116819}} | ||
+ | |||
+ | It can be downloaded as a {{iacl|~shuo/data/cerebellum-parcellation_v2.simg|Singularity image}}. The download is 1.3GB. If you use it please cite the NeurooImage paper. | ||
If you have any questions, please email Shuo Han at <code>shan50@jhu.edu</code>. | If you have any questions, please email Shuo Han at <code>shan50@jhu.edu</code>. | ||
+ | |||
{{h3|What the Singularity image can do}} | {{h3|What the Singularity image can do}} | ||
Line 16: | Line 19: | ||
* The parcellation is transformed back to the original space using ANTs with the "MultiLabel" interpolation. | * The parcellation is transformed back to the original space using ANTs with the "MultiLabel" interpolation. | ||
* Generate .png files of slices in the axial, coronal, and sagittal views for quality control. | * Generate .png files of slices in the axial, coronal, and sagittal views for quality control. | ||
+ | |||
{{h3|File structure}} | {{h3|File structure}} | ||
Line 26: | Line 30: | ||
* '''<code>*n4_mni_seg_post_inverse.nii.gz</code>''' is <u>the final post-processed result in the original space</u>. | * '''<code>*n4_mni_seg_post_inverse.nii.gz</code>''' is <u>the final post-processed result in the original space</u>. | ||
* The subfolder '''<code>pics/final/</code>''' contains the axial, coronal, and sagittal slices of the file '''<code>*n4_mni_seg_post_inverse.nii.gz</code>'''. | * The subfolder '''<code>pics/final/</code>''' contains the axial, coronal, and sagittal slices of the file '''<code>*n4_mni_seg_post_inverse.nii.gz</code>'''. | ||
+ | |||
{{h3|Installation}} | {{h3|Installation}} | ||
* Install [https://www.sylabs.io/guides/2.6/user-guide/installation.html Singularity 2.6] | * Install [https://www.sylabs.io/guides/2.6/user-guide/installation.html Singularity 2.6] | ||
+ | |||
{{h3|Example Usage}} | {{h3|Example Usage}} |
Revision as of 19:23, 5 June 2020
<meta name="title" content="ACAPULCO: Cerebellum Parcellation with Convolutional Neural Networks"/>
Cerebellum Parcellation with Convolutional Neural Networks
Automatic cerebellum anatomical parcellation using U-Net with locally constrained optimization (ACAPULCO) is our current cerebellum parcellation method. The associated publication is:
- S. Han, A. Carass, Y. He, and J.L. Prince, "Automatic Cerebellum Anatomical Parcellation using U-Net with Locally Constrained Optimization", NeuroImage, 218:116819, 2020. (doi)
It can be downloaded as a Singularity image. The download is 1.3GB. If you use it please cite the NeurooImage paper.
If you have any questions, please email Shuo Han at shan50@jhu.edu
.
What the Singularity image can do
The Singularity performs the following steps:
- ROBEX is used to estimate a brain mask. This mask is then smoothed to generate a brain weight image. The mask is not used for skull-stripping. It is only used for the bias field correction below.
- N4 from ANTs is used to perform the bias field correction. The bias field is estimated using the weight image calculated above.
- The image is rigidly registered to the ICBM2009c nonlinear symmetric template using the ANTs package.
- The cerebellum of an MNI-registered MPRAGE image is parcellated using the method described in "Shuo Han, et al., Cerebellum parcellation with convolutional neural networks, SPIE 2019 Medical Imaging Image Processing".
- Removing the neck should improve the results, such as using
robustfov
from fsl, but it is not done in this Singularity image.
- Removing the neck should improve the results, such as using
- The parcellation is transformed back to the original space using ANTs with the "MultiLabel" interpolation.
- Generate .png files of slices in the axial, coronal, and sagittal views for quality control.
File structure
The processing will create subfolders n4/
, mni/
, parc/
, and pics/
under the output folder. The final parcellation result is directly under the output folder.
*n4.nii.gz
is the bias field corrected image*n4_mni.nii.gz
is the image in the MNI space*n4_mni_seg.nii.gz
is the parcellation from the deep networks*n4_mni_seg_post.nii.gz
is the post-processed result.*n4_mni_seg_post_inverse.nii.gz
is the final post-processed result in the original space.- The subfolder
pics/final/
contains the axial, coronal, and sagittal slices of the file*n4_mni_seg_post_inverse.nii.gz
.
Installation
- Install Singularity 2.6
Example Usage
- The Singularity image can only run on CPU although TensorFlow and Keras are used, because the Singularity image only contains the CPU version of TensorFlow.
- Assume that the Singularity image is
~/cerebellum-parcellation.simg
, the image to parcellate isimage.nii.gz
, and the output folder is~/output
singularity run ~/cerebellum-parcellation.simg -i ~/image.nii.gz -o ~/output
- If the
image.nii.gz
is under/path/to/image
which is not under your home directory
singularity run -B /path/to/image:/mnt ~/cerebellum-parcellation.simg -i /mnt/image.nii.gz -o /mnt/output
- Print help
singularity run ~/cerebellum-parcellation.simg -h
Cerebellum labels
"12": "Corpus_Medullare", "33": "Left_Lobules_I-III", "36": "Right_Lobules_I-III", "43": "Left_Lobule_IV", "46": "Right_Lobule_IV", "53": "Left_Lobule_V", "56": "Right_Lobule_V", "63": "Left_Lobule_VI", "60": "Vermis_VI", "66": "Right_Lobule_VI", "73": "Left_Lobule_VIIAf", "76": "Right_Lobule_VIIAf", "74": "Left_Lobule_VIIAt", "70": "Vermis_VII", "77": "Right_Lobule_VIIAt", "75": "Left_Lobule_VIIB", "78": "Right_Lobule_VIIB", "83": "Left_Lobule_VIIIA", "80": "Vermis_VIII", "86": "Right_Lobule_VIIIA", "84": "Left_Lobule_VIIIB", "87": "Right_Lobule_VIIIB", "93": "Left_Lobule_IX", "90": "Vermis_IX", "96": "Right_Lobule_IX", "103": "Left_Lobule_X", "100": "Vermis_X", "106": "Right_Lobule_X"