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

From Slicer Wiki
Jump to: navigation, search
m (Chribaue moved page Documentation/Nightly/Modules/PETLiverUptakeMeasurement to Documentation/Nightly/Modules/PETLiverUptakeMeasurementCLI: There's a new PETLiverUptakeMeasurement module and the old CLI PETLiverUptakeMeasurement should still be...)
 
(2 intermediate revisions by the same user not shown)
Line 31: Line 31:
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
{{documentation/{{documentation/version}}/module-section|Tutorial - Fully Automated Liver Uptake Measurement}}
+
{{documentation/{{documentation/version}}/module-section|Basic usage}}
  
Step 1) Load SUV normalized whole-body FDG-18 PET scan using the [[Documentation/{{documentation/version}}/Modules/DICOMPETSUVPlugin|DICOM PET SUV Plugin]] which is part of the UIowa QIN [[Documentation/{{documentation/version}}/Extensions/PETDICOM|PET DICOM Extension]].
+
# Load SUV normalized whole-body FDG-18 PET scan. For DICOM datasets this can be accomplished using the [[Documentation/{{documentation/version}}/Modules/DICOMPETSUVPlugin|DICOM PET SUV Plugin]] which is part of the UIowa QIN [[Documentation/{{documentation/version}}/Extensions/PETDICOM|PET DICOM Extension]].
 +
# Go to the “PET Liver Uptake Measurement” module.
 +
# Select the loaded PET scan as "Input Volume".
 +
# (Optional) Under "Output Volume" select "Create new LabelMapVolume". If an output volume is selected, the tool will visualize the identified liver reference region which is utilized for uptake measurement.
 +
# Click "Apply".
 +
# In section "Measurements" read the measured "Mean", "Standard Deviation" and "Median" SUV values of the identified liver reference region.
  
Step 2) Go to the “PET Liver Uptake Measurement” module.
+
<!-- ---------------------------- -->
 +
{{documentation/{{documentation/version}}/module-section|Options}}
  
Step 3) Select the loaded PET scan as "Input Volume".
+
[[File:PETLiverUptakeMeasurementOptions.png|600px|right|Options]]
  
Step 4) (Optional) Under "Output Volume" select "Create new LabelMapVolume". If an output volume is selected, the tool will visualize the identified liver reference region which is utilized for uptake measurement.
+
In unusual circumstances the tool may not be able to automatically identify a correct measurement region in the liver. E.g. the tool was developed for whole-body FDG-18 PET scans and assumes that part of the brain is visible as a reference point for localization of the liver. In such cases, the user may provide additional information to the algorithm:
  
Step 5) Click "Apply".
+
* Region: A ROI box may be provided to indicate the rough location of the liver. The tool will only search for a measurement region with its center inside of the provided ROI. Usage: (a) Select ROI from the annotation toolbar. (b) Place ROI around the liver by first clicking at the ROI’s center and then at a corner point. (c) From the “Region” drop-down list select the created ROI “R”.
 +
[[File:PETLiverUptakeMeasurement_init_roi.png|100px|Initialize ROI placement]] [[File:PETLiverUptakeMeasurement_place_roi_annotated.png|300px|Place ROI around liver]]
  
Step 6) In section "Measurements" read the measured "Mean", "Standard Deviation" and "Median" SUV values of the identified liver reference region.
+
* Upper and lower thresholds: These thresholds indicate the rough expected SUV range for the liver tissue, separating it from non-liver tissue.
 
+
* Erosion distance: Distance between the measurement region and the identified liver’s boundary. This allows excluding voxels from the measurement region which are affected by partial volume effects.
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|Tutorial - Liver Uptake Measurement with User Guidance}}
 
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-section|References}}
 
{{documentation/{{documentation/version}}/module-section|References}}
* C. Bauer, S. Sun, W. Sun, J. Otis, A. Wallace, B. J. Smith, J. J. Sunderland, M. M. Graham, J. M. Buatti and R. R. Beichel "Automated measurement of uptake in cerebellum, liver, and aortic arch in full-body FDG PET/CT scans", in Medical Physics, 2012. [http://dx.doi.org/10.1118/1.4711815 http://dx.doi.org/10.1118/1.4711815]
+
* C. Bauer, S. Sun, W. Sun, J. Otis, A. Wallace, B. J. Smith, J. J. Sunderland, M. M. Graham, J. M. Buatti and R. R. Beichel: "Automated measurement of uptake in cerebellum, liver, and aortic arch in full-body FDG PET/CT scans", in Medical Physics, 2012. [http://dx.doi.org/10.1118/1.4711815 http://dx.doi.org/10.1118/1.4711815]
  
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->
 
{{documentation/{{documentation/version}}/module-footer}}
 
{{documentation/{{documentation/version}}/module-footer}}
 
<!-- ---------------------------- -->
 
<!-- ---------------------------- -->

Latest revision as of 14:19, 7 April 2017

Home < Documentation < Nightly < Modules < PETLiverUptakeMeasurementCLI


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


Introduction and Acknowledgements

Acknowledgments: The UIowa QIN PET Liver Uptake Measurement tool was funded in part by Quantitative Imaging to Assess Response in Cancer Therapy Trials NIH grant U01-CA140206 and Quantitative Image Informatics for Cancer Research (QIICR) NIH grant U24 CA180918.
Authors: Christian Bauer (University of Iowa), Markus van Tol (University of Iowa)
Contributors: Ethan Ulrich (University of Iowa), Andrey Fedorov (SPL), Reinhard Beichel (University of Iowa), John Buatti (University of Iowa)
Contact: <email>qin@iibi.uiowa.edu</email>

License: Slicer License

The University of Iowa (UIowa)  
Quantitative Image Informatics for Cancer Research  
National Alliance for Medical Image Computing (NA-MIC)  

Module Description

Tool for automated measurement of liver uptake in SUV normalized whole-body FDG-18 PET scans. The tool automatically identifies a spherical region inside of the liver and measures mean, standard deviation and median uptake in the identified region. In the majority of cases the user only needs to specify the input PET scan. However, to be able to deal with unusual cases where standard parameters regarding the liver's location or appearance are not applicable, the tool allows the user to provide additional guidance to the algorithm.

Screenshot

Basic usage

  1. Load SUV normalized whole-body FDG-18 PET scan. For DICOM datasets this can be accomplished using the DICOM PET SUV Plugin which is part of the UIowa QIN PET DICOM Extension.
  2. Go to the “PET Liver Uptake Measurement” module.
  3. Select the loaded PET scan as "Input Volume".
  4. (Optional) Under "Output Volume" select "Create new LabelMapVolume". If an output volume is selected, the tool will visualize the identified liver reference region which is utilized for uptake measurement.
  5. Click "Apply".
  6. In section "Measurements" read the measured "Mean", "Standard Deviation" and "Median" SUV values of the identified liver reference region.

Options

Options

In unusual circumstances the tool may not be able to automatically identify a correct measurement region in the liver. E.g. the tool was developed for whole-body FDG-18 PET scans and assumes that part of the brain is visible as a reference point for localization of the liver. In such cases, the user may provide additional information to the algorithm:

  • Region: A ROI box may be provided to indicate the rough location of the liver. The tool will only search for a measurement region with its center inside of the provided ROI. Usage: (a) Select ROI from the annotation toolbar. (b) Place ROI around the liver by first clicking at the ROI’s center and then at a corner point. (c) From the “Region” drop-down list select the created ROI “R”.

Initialize ROI placement Place ROI around liver

  • Upper and lower thresholds: These thresholds indicate the rough expected SUV range for the liver tissue, separating it from non-liver tissue.
  • Erosion distance: Distance between the measurement region and the identified liver’s boundary. This allows excluding voxels from the measurement region which are affected by partial volume effects.

References

  • C. Bauer, S. Sun, W. Sun, J. Otis, A. Wallace, B. J. Smith, J. J. Sunderland, M. M. Graham, J. M. Buatti and R. R. Beichel: "Automated measurement of uptake in cerebellum, liver, and aortic arch in full-body FDG PET/CT scans", in Medical Physics, 2012. http://dx.doi.org/10.1118/1.4711815