Difference between revisions of "Cerebellum CNN"

From IACL
Jump to navigation Jump to search
(Updated with the new publication.)
(Update.)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
<meta name="title" content="ACAPULCO: 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}}
Line 6: Line 6:
 
{{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}}
 
{{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>.
 
  
 +
{|align="center" style="width:75%; border:2px #e99095 solid; background:#ffffff; text-align:left;"
 +
|-
 +
| colspan="3" align="center" | '''ACAPULCO'''
 +
|-
 +
<!--
 +
| {{iacl|~shuo/data/acapulco_022.tar.gz|Docker image CPU}}
 +
| 1.8GB
 +
|-
 +
| {{iacl|~shuo/data/acapulco_022_gpu.tar.gz|Docker image GPU}}
 +
| 2.5GB
 +
|-
 +
-->
 +
| {{iacl|~shuo/data/acapulco_030.sif|Singularity image CPU}}
 +
| Feb 27  2022
 +
| 1.8GB
 +
|-
 +
| {{iacl|~shuo/data/acapulco_030_gpu.sif|Singularity image GPU}}
 +
| Feb 27  2022
 +
| 2.5GB
 +
|-
 +
|}
  
−
{{h3|What the Singularity image can do}}
 
−
The Singularity performs the following steps:
 
−
* [https://www.nitrc.org/projects/robex 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 [http://stnava.github.io/ANTs/ 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 [http://www.bic.mni.mcgill.ca/ServicesAtlases/ICBM152NLin2009 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 <code>robustfov</code> from [https://fsl.fmrib.ox.ac.uk/fslcourse/lectures/practicals/intro2/index.html fsl], but it is not done in this Singularity image.
 
−
* 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.
 
  
 +
If you use it please cite the above paper. If you have any questions, please email Shuo Han at <code>shan50 _AT_ jhu.edu</code>.
  
−
{{h3|File structure}}
 
  
−
The processing will create subfolders '''<code>n4/</code>''', '''<code>mni/</code>''', '''<code>parc/</code>''', and '''<code>pics/</code>''' under the output folder. The final parcellation result is directly under the output folder.
+
{{h3|Instructions}}
−
* '''<code>*n4.nii.gz</code>''' is the bias field corrected image
 
−
* '''<code>*n4_mni.nii.gz</code>''' is the image in the MNI space
 
−
* '''<code>*n4_mni_seg.nii.gz</code>''' is the parcellation from the deep networks
 
−
* '''<code>*n4_mni_seg_post.nii.gz</code>''' is the post-processed result.
 
−
* '''<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 instructions are available [https://gitlab.com/shuohan/keras-unet-cerebellum/-/blob/master/README.md here].
  
−
{{h3|Installation}}
+
{{h3| Delineation protocols: region names and voxel values}}
−
* Install [https://www.sylabs.io/guides/2.6/user-guide/installation.html Singularity 2.6]
 
  
 +
* Adult training data:
 +
"Background":            0,
 +
"Corpus Medullare":      12,
 +
"Left I-III":            33,
 +
"Right I-III":            36,
 +
"Left IV":                43,
 +
"Rigt IV":                46,
 +
"Left V":                53,
 +
"Right V":                56,
 +
"Vermis VI":              60,
 +
"Left VI":                63,
 +
"Right VI":              66,
 +
"Vermis VII":            70,
 +
"Left Crus I":            73,
 +
"Left Crus II":          74,
 +
"Left VIIB":              75,
 +
"Right Crus I":          76,
 +
"Right Crus II":          77,
 +
"Right VIIB":            78,
 +
"Vermis VIII":            80,
 +
"Left VIIIA":            83,
 +
"Left VIIIB":            84,
 +
"Right VIIIA":            86,
 +
"Right VIIIB":            87,
 +
"Vermis IX":              90,
 +
"Left IX":                93,
 +
"Right IX":              96,
 +
"Vermis X":              100,
 +
"Left X":                103,
 +
"Right X":              106
  
−
{{h3|Example Usage}}
 
−
* The Singularity image can only run on '''CPU''' although [https://www.tensorflow.org TensorFlow] and [https://keras.io Keras] are used, because the Singularity image only contains the CPU version of TensorFlow.
 
  
−
* Assume that the Singularity image is <code>~/cerebellum-parcellation.simg</code>, the image to parcellate is <code>image.nii.gz</code>, and the output folder is <code>~/output</code>
 
  
−
singularity run ~/cerebellum-parcellation.simg -i ~/image.nii.gz -o ~/output
+
* Pediatric training data:
−
 
+
  "Background":             0,
−
* If the <code>image.nii.gz</code> is under <code>/path/to/image</code> which is not under your home directory
+
  "Right Lobules I-V":      3,
−
 
+
"Right Lobule VI":         4,
−
singularity run -B /path/to/image:/mnt ~/cerebellum-parcellation.simg -i /mnt/image.nii.gz -o /mnt/output
+
"Right Crus I":           5,
−
 
+
"Right Crus II/VIIB":     6,
−
* Print help
+
"Right Lobule VIII":       7,
−
  singularity run ~/cerebellum-parcellation.simg -h
+
"Right Lobule IX":         8,
−
 
+
"Right Lobule X":         9,
−
 
+
  "Left Lobules I-V":       10,
−
{{h3|Cerebellum labels}}
+
  "Left Lobule VI":         11,
−
    "12": "Corpus_Medullare",
+
  "Left Crus I":           12,
−
    "33": "Left_Lobules_I-III",
+
  "Left Crus II/VIIB":     13,
−
    "36": "Right_Lobules_I-III",
+
  "Left Lobule VIII":       14,
−
    "43": "Left_Lobule_IV",
+
  "Left Lobule IX":         15,
−
    "46": "Right_Lobule_IV",
+
  "Left Lobule X":         16,
−
    "53": "Left_Lobule_V",
+
  "Vermis I-V":             17,
−
    "56": "Right_Lobule_V",
+
  "Vermis VI-VII":         18,
−
    "63": "Left_Lobule_VI",
+
"Vermis VIII-X":         19,
−
    "60": "Vermis_VI",
+
"Corpus Medullare":       20
−
    "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"
 

Latest revision as of 18:19, 2 November 2022

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)


ACAPULCO
Singularity image CPU Feb 27 2022 1.8GB
Singularity image GPU Feb 27 2022 2.5GB


If you use it please cite the above paper. If you have any questions, please email Shuo Han at shan50 _AT_ jhu.edu.


Instructions

The instructions are available here.

Delineation protocols: region names and voxel values

  • Adult training data:
"Background":             0,
"Corpus Medullare":       12, 
"Left I-III":             33, 
"Right I-III":            36, 
"Left IV":                43, 
"Rigt IV":                46, 
"Left V":                 53, 
"Right V":                56, 
"Vermis VI":              60, 
"Left VI":                63, 
"Right VI":               66, 
"Vermis VII":             70, 
"Left Crus I":            73, 
"Left Crus II":           74, 
"Left VIIB":              75, 
"Right Crus I":           76, 
"Right Crus II":          77, 
"Right VIIB":             78, 
"Vermis VIII":            80, 
"Left VIIIA":             83, 
"Left VIIIB":             84, 
"Right VIIIA":            86, 
"Right VIIIB":            87, 
"Vermis IX":              90, 
"Left IX":                93, 
"Right IX":               96, 
"Vermis X":              100,
"Left X":                103,
"Right X":               106


  • Pediatric training data:
"Background":              0,
"Right Lobules I-V":       3,
"Right Lobule VI":         4,
"Right Crus I":            5,
"Right Crus II/VIIB":      6,
"Right Lobule VIII":       7,
"Right Lobule IX":         8,
"Right Lobule X":          9,
"Left Lobules I-V":       10,
"Left Lobule VI":         11,
"Left Crus I":            12,
"Left Crus II/VIIB":      13,
"Left Lobule VIII":       14,
"Left Lobule IX":         15,
"Left Lobule X":          16,
"Vermis I-V":             17,
"Vermis VI-VII":          18,
"Vermis VIII-X":          19,
"Corpus Medullare":       20
Retrieved from "https://iacl.ece.jhu.edu/index.php?title=Cerebellum_CNN&oldid=18241"