Difference between revisions of "Documentation/Nightly/Modules/ComputeGLRLMFeatures"

From Slicer Wiki
Jump to: navigation, search
 
(5 intermediate revisions by the same user not shown)
Line 11: Line 11:
 
'''''Contributors:''''' Beatriz Paniagua (Kitware Inc), Lucia Cevidanes (University of Michigan - School of Dentistry), Erika Benavides (University of Michigan - School of Dentistry), Antônio Carlos de Oliveira Ruellas (University of Michigan - School of Dentistry)<br>
 
'''''Contributors:''''' Beatriz Paniagua (Kitware Inc), Lucia Cevidanes (University of Michigan - School of Dentistry), Erika Benavides (University of Michigan - School of Dentistry), Antônio Carlos de Oliveira Ruellas (University of Michigan - School of Dentistry)<br>
 
'''''Contact:''''' Jean-Baptiste Vimort, <email>jb.vimort@kitware.com</email><br>
 
'''''Contact:''''' Jean-Baptiste Vimort, <email>jb.vimort@kitware.com</email><br>
'''''Acknowledgments:''''' This work was supported by the National Institute of Health (NIH) National Institute for Dental and Cranio-
+
'''''Acknowledgments:''''' This work was supported by the National Institute of Health (NIH) National Institute for Dental and Craniofacial Research (NIDCR) grant R21DE025306 (Textural Biomarkers of Arthritis for the Subchondral Bone in the Temporomandibular Joint), NIDCR grant R01DE024450 (Quantification of 3D bony Changes in
facial Research (NIDCR) grant R01EB021391 (Textural Biomarkers of Arthritis for the Subchondral Bone
+
Temporomandibular Joint Osteoarthritis) and National Institute of Biomedical Imaging and Bioengineering NIBIB) grant R01EB021391 (Shape Analysis Toolbox for Medical Image Computing Projects).<br>
in the Temporomandibular Joint), NIDCR grant R01DE024450 (Quantification of 3D bony Changes in
 
Temporomandibular Joint Osteoarthritis) and National Institute of Biomedical Imaging and Bioengineering
 
(NIBIB) grant R01EB021391 (Shape Analysis Toolbox for Medical Image Computing Projects).<br>
 
 
'''''License:''''' [http://www.apache.org/licenses/LICENSE-2.0.html Apache License, Version 2.0]
 
'''''License:''''' [http://www.apache.org/licenses/LICENSE-2.0.html Apache License, Version 2.0]
  
Line 28: Line 25:
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
 
{{documentation/{{documentation/version}}/module-section|Module Description}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
This module can be used in order to compute some run length texture features over the input image. The computation of the run length features is based on the grey level run length matrix (GLRLM) computed with [https://itk.org/Doxygen/html/classitk_1_1Statistics_1_1ScalarImageToRunLengthFeaturesFilter.html itk::itkScalarImageToRunLengthFeaturesImageFilter].<br>
+
This module can be used in order to compute run length texture features over the input image. The computation of the run length features is based on the grey level run length matrix (GLRLM) computed with [https://itk.org/Doxygen/html/classitk_1_1Statistics_1_1ScalarImageToRunLengthFeaturesFilter.html itk::itkScalarImageToRunLengthFeaturesFilter].<br>
 
+
The GLRLM matrix describes the texture of the whole image, it is then used to compute the following run length texture features:
 +
* short run emphasis
 +
* long run emphasis
 +
* grey level non uniformity
 +
* run length non uniformity
 +
* low grey level run emphasis
 +
* high grey level run emphasis
 +
* short run low grey level emphasis
 +
* short run high grey level emphasis
 +
* long run low grey level emphasis
 +
* long run high grey level emphasis
  
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
 
{{documentation/{{documentation/version}}/module-section|Use Cases}}
Line 37: Line 44:
 
* <span style="color:blue">'''''Inputs'''''</span>:  
 
* <span style="color:blue">'''''Inputs'''''</span>:  
 
** <span style="color:green">'''Input volume'''</span> [<span style="color:orange">index: 0</span>] : Input Volume
 
** <span style="color:green">'''Input volume'''</span> [<span style="color:orange">index: 0</span>] : Input Volume
** <span style="color:green">'''Input mask'''</span> [<span style="color:orange">-s --inputMask</span>] : A mask defining the region over which texture features will be calculated
+
** <span style="color:green">'''Input mask'''</span> [<span style="color:orange">-s --inputMask</span>] (<span style="color:purple">None</span>) : A mask defining the region over which texture features will be calculated
** <span style="color:green">'''Inside Mask Value'''</span> [<span style="color:orange">-i --inputMask</span>] : The pixel value that defines the ”inside” of the mask
+
** <span style="color:green">'''Inside Mask Value'''</span> [<span style="color:orange">-i --inputMask</span>] (<span style="color:purple">1</span>) : The pixel value that defines the ”inside” of the mask
** <span style="color:green">'''Number of Intensity bins'''</span> [<span style="color:orange">-b --binNumber</span>] : The number of intensity bins
+
** <span style="color:green">'''Number of Intensity bins'''</span> [<span style="color:orange">-b --binNumber</span>] (<span style="color:purple">10</span>) : The number of intensity bins
** <span style="color:green">'''Pixel Intensity Min'''</span> [<span style="color:orange">-p --pixelIntensityMin</span>] : Minnimum of the pixel intensity range over which the features will be calculated
+
** <span style="color:green">'''Pixel Intensity Min'''</span> [<span style="color:orange">-p --pixelIntensityMin</span>] (<span style="color:purple">0</span>) : Minnimum of the pixel intensity range over which the features will be calculated
** <span style="color:green">'''Pixel Intensity Max'''</span> [<span style="color:orange">-P --pixelIntensityMax</span>] : Maximum of the pixel intensity range over which the features will be calculated
+
** <span style="color:green">'''Pixel Intensity Max'''</span> [<span style="color:orange">-P --pixelIntensityMax</span>] (<span style="color:purple">4000</span>) : Maximum of the pixel intensity range over which the features will be calculated
** <span style="color:green">'''Distance Min'''</span> [<span style="color:orange">-d --distanceMin</span>] : Minnimum of the distance range over which the features will be calculated
+
** <span style="color:green">'''Distance Min'''</span> [<span style="color:orange">-d --distanceMin</span>] (<span style="color:purple">0.0</span>) : Minnimum of the distance range over which the features will be calculated
** <span style="color:green">'''Distance Max'''</span> [<span style="color:orange">-D --distanceMax</span>] : Maximum of the distance range over which the features will be calculated
+
** <span style="color:green">'''Distance Max'''</span> [<span style="color:orange">-D --distanceMax</span>] (<span style="color:purple">1.0</span>) : Maximum of the distance range over which the features will be calculated
 
* <span style="color:blue">'''''Outputs'''''</span>:  
 
* <span style="color:blue">'''''Outputs'''''</span>:  
 
** <span style="color:green">'''Short Run Emphasis'''</span> [<span style="color:orange">output</span>] : Short Run Emphasis feature value
 
** <span style="color:green">'''Short Run Emphasis'''</span> [<span style="color:orange">output</span>] : Short Run Emphasis feature value
Line 58: Line 65:
 
** <span style="color:green">'''Output Vector'''</span> [<span style="color:orange">output</span>] : Output vector containing all the feature value stored in the same order than previously  
 
** <span style="color:green">'''Output Vector'''</span> [<span style="color:orange">output</span>] : Output vector containing all the feature value stored in the same order than previously  
 
|}
 
|}
 +
 +
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-section|Additional Information}}
 +
 +
* [http://www.insight-journal.org/browse/publication/985 InsightJournal article]
 +
* [https://github.com/InsightSoftwareC BoneTextureExtension Tutorial]
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 14:46, 6 July 2017

Home < Documentation < Nightly < Modules < ComputeGLRLMFeatures


For the latest Slicer documentation, visit the read-the-docs.


Introduction and Acknowledgements

Extensions: BoneTextureExtesion
Author: Jean-Baptise Vimort, Kitware Inc.
Contributors: Beatriz Paniagua (Kitware Inc), Lucia Cevidanes (University of Michigan - School of Dentistry), Erika Benavides (University of Michigan - School of Dentistry), Antônio Carlos de Oliveira Ruellas (University of Michigan - School of Dentistry)
Contact: Jean-Baptiste Vimort, <email>jb.vimort@kitware.com</email>
Acknowledgments: This work was supported by the National Institute of Health (NIH) National Institute for Dental and Craniofacial Research (NIDCR) grant R21DE025306 (Textural Biomarkers of Arthritis for the Subchondral Bone in the Temporomandibular Joint), NIDCR grant R01DE024450 (Quantification of 3D bony Changes in Temporomandibular Joint Osteoarthritis) and National Institute of Biomedical Imaging and Bioengineering NIBIB) grant R01EB021391 (Shape Analysis Toolbox for Medical Image Computing Projects).
License: Apache License, Version 2.0


Module Description

This module can be used in order to compute run length texture features over the input image. The computation of the run length features is based on the grey level run length matrix (GLRLM) computed with itk::itkScalarImageToRunLengthFeaturesFilter.
The GLRLM matrix describes the texture of the whole image, it is then used to compute the following run length texture features:

  • short run emphasis
  • long run emphasis
  • grey level non uniformity
  • run length non uniformity
  • low grey level run emphasis
  • high grey level run emphasis
  • short run low grey level emphasis
  • short run high grey level emphasis
  • long run low grey level emphasis
  • long run high grey level emphasis

Use Cases

ComputeGLRLMFeatures-Interface.png
  • Inputs:
    • Input volume [index: 0] : Input Volume
    • Input mask [-s --inputMask] (None) : A mask defining the region over which texture features will be calculated
    • Inside Mask Value [-i --inputMask] (1) : The pixel value that defines the ”inside” of the mask
    • Number of Intensity bins [-b --binNumber] (10) : The number of intensity bins
    • Pixel Intensity Min [-p --pixelIntensityMin] (0) : Minnimum of the pixel intensity range over which the features will be calculated
    • Pixel Intensity Max [-P --pixelIntensityMax] (4000) : Maximum of the pixel intensity range over which the features will be calculated
    • Distance Min [-d --distanceMin] (0.0) : Minnimum of the distance range over which the features will be calculated
    • Distance Max [-D --distanceMax] (1.0) : Maximum of the distance range over which the features will be calculated
  • Outputs:
    • Short Run Emphasis [output] : Short Run Emphasis feature value
    • Long Run Emphasis [output] : Long Run Emphasis feature value
    • Grey Level Non-uniformity [output] : Grey Level Non-uniformity feature value
    • Run Length Non-uniformity [output] : Run Length Non-uniformity feature value
    • Low Grey Level Run Emphasis [output] : Low Grey Level Run Emphasis feature value
    • High Grey Level Run Emphasis [output] : High Grey Level Run Emphasis feature value
    • Short Run Low Grey Level Emphasis [output] : Short Run Low Grey Level Emphasis feature value
    • Short Run High Grey Level Emphasis [output] : Short Run High Grey Level Emphasis feature value
    • Long Run Low Grey Level Emphasis [output] : Long Run Low Grey Level Emphasis feature value
    • Long Run High Grey Level Emphasis [output] : Long Run High Grey Level Emphasis feature value
  • Advanced:
    • Output Vector [output] : Output vector containing all the feature value stored in the same order than previously

Additional Information

Similar Modules

N/A

Information for Developers

The source code is available on github