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

From Slicer Wiki
Jump to: navigation, search
m (improved Intro & Acknowlegments)
m (added GUI screenshot)
Line 60: Line 60:
 
===Quick Tour of Features and Use===
 
===Quick Tour of Features and Use===
  
−
A list panels in the interface, their features, what they mean, and how to use them.
+
A list of panels in the interface, their features, what they mean, and how to use them.
 
{|
 
{|
 
|
 
|
 
* <span style="color:blue">'''''Input Image'''''</span>:  
 
* <span style="color:blue">'''''Input Image'''''</span>:  
−
** <span style="color:green">'''PET DICOM volume path'''</span> [<span style="color:orange">----petDICOMPath</span>] [<span style="color:pink">--p</span>]:  
+
** <span style="color:green">'''PET DICOM volume path'''</span> [<span style="color:orange">----petDICOMPath</span>] [<span style="color:pink">--p</span>]: Input path to a directory containing a PET DICOM series with header information for SUV computation
  
 
* <span style="color:blue">'''''Output'''''</span>:  
 
* <span style="color:blue">'''''Output'''''</span>:  
−
** <span style="color:green">'''RWV mapping object DICOM volume path'''</span> [<span style="color:orange">----rwvmDICOMPath</span>] [<span style="color:pink">--r</span>]:  
+
** <span style="color:green">'''RWV mapping object DICOM volume path'''</span> [<span style="color:orange">----rwvmDICOMPath</span>] [<span style="color:pink">--r</span>]: Output path to a directory to store the RWV object with the SUV computation result
  
−
** <span style="color:green">'''Radioactivity Units'''</span>  :  
+
** <span style="color:green">'''Radioactivity Units'''</span>  : DICOM Tag (0054,1001) - Radioactivity Units
  
−
** <span style="color:green">'''Weight Units'''</span>  :  
+
** <span style="color:green">'''Weight Units'''</span>  : Patient weight units (always assumed to be kg)
  
−
** <span style="color:green">'''Height Units'''</span>  :  
+
** <span style="color:green">'''Height Units'''</span>  : Patient weight units (always assumed to be meters)
  
−
** <span style="color:green">'''Volume Units'''</span>  :  
+
** <span style="color:green">'''Volume Units'''</span>  : Volume units for concentration (always assumed to be mL)
  
−
** <span style="color:green">'''Injected Dose'''</span>  :  
+
** <span style="color:green">'''Injected Dose'''</span>  : DICOM Tag (0018,1074) - Radionuclide Total Dose
  
−
** <span style="color:green">'''Patient Weight'''</span>  :  
+
** <span style="color:green">'''Patient Weight'''</span>  : DICOM Tag (0010,1030) - Patient Weight
  
−
** <span style="color:green">'''Patient Height'''</span>  :  
+
** <span style="color:green">'''Patient Height'''</span>  : DICOM Tag (0010,1020) - Patient Size
  
−
** <span style="color:green">'''Patient Sex'''</span>  :  
+
** <span style="color:green">'''Patient Sex'''</span>  : DICOM Tag (0010,0040) - Patient Sex
  
−
** <span style="color:green">'''Series Reference Time'''</span>  :  
+
** <span style="color:green">'''Series Reference Time'''</span>  : DICOM Tag (0008,0031) - Series Time
  
−
** <span style="color:green">'''Injection Time'''</span>  :  
+
** <span style="color:green">'''Injection Time'''</span>  : DICOM Tag (0018,1072) - Radiopharmaceutical Start Time
  
−
** <span style="color:green">'''Decay Correction'''</span>  :  
+
** <span style="color:green">'''Decay Correction'''</span>  : DICOM Tag (0054,1102) - Decay Correction
  
−
** <span style="color:green">'''Decay Factor'''</span>  :  
+
** <span style="color:green">'''Decay Factor'''</span>  : DICOM Tag (0054,1321) - Decay Factor
  
−
** <span style="color:green">'''Radionuclide Half-life'''</span>  :  
+
** <span style="color:green">'''Radionuclide Half-life'''</span>  : DICOM Tag (0018,1075) - Radionuclide Half-Life
  
−
** <span style="color:green">'''Frame Reference Time'''</span>  :  
+
** <span style="color:green">'''Frame Reference Time'''</span>  : DICOM Tag (0054,1300) - Frame Reference Time
  
−
** <span style="color:green">'''SUVbw Conversion Factor'''</span>  :  
+
** <span style="color:green">'''SUVbw Conversion Factor'''</span>  : Standardized Uptake Value (body weight) Conversion Factor
  
−
** <span style="color:green">'''SUVlbm Conversion Factor'''</span>  :  
+
** <span style="color:green">'''SUVlbm Conversion Factor'''</span>  : Standardized Uptake Value (lean body mass) Conversion Factor
  
−
** <span style="color:green">'''SUVbsa Conversion Factor'''</span>  :  
+
** <span style="color:green">'''SUVbsa Conversion Factor'''</span>  : Standardized Uptake Value (body surface area) Conversion Factor
  
−
** <span style="color:green">'''SUVibw Conversion Factor'''</span>  :  
+
** <span style="color:green">'''SUVibw Conversion Factor'''</span>  : Standardized Uptake Value (ideal body weight) Conversion Factor
  
−
** <span style="color:green">'''RWVM File'''</span>  :  
+
** <span style="color:green">'''RWVM File'''</span>  : Real World Value Mapping object file
  
−
|[[Image:screenshotBlankNotOptional.png|thumb|280px|User Interface]]
+
|[[Image:SUV_Factor_Calculator_GUI.png|thumb|400px|User Interface]]
 
|}
 
|}
  

Revision as of 18:22, 25 August 2014

Home < Documentation < Nightly < Modules < SUVFactorCalculator


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


Introduction and Acknowledgements

Acknowledgments: This work is funded in part by Quantitative Image Informatics for Cancer Research (QIICR) NIH grant U24 CA180918.
Authors: Andrey Fedorov (SPL), Ethan Ulrich (University of Iowa)
Contributors: Markus Van Tol (University of Iowa), Hans Johnson (University of Iowa), Wendy Plesniak (SPL, BWH), Nicole Aucoin (SPL, BWH), Ron Kikinis (SPL, BWH)
Contact: Ethan Ulrich, <email>ethan-ulrich@uiowa.edu</email>

License: Slicer License

Quantitative Image Informatics for Cancer Research  
National Alliance for Medical Image Computing (NA-MIC)  

General Information

Work in progress
 Section under construction.

Module Type & Category

Type: CLI

Category: Quantification

Module Description

Program title SUV Factor Calculator
Program description This command line interface module takes a PET DICOM series and creates a Real World Value Mapping (RWVM) file including 4 types of Standardized Uptake Value conversion factors (SUVbw, SUVlbm, SUVbsa, SUVibw).
Program documentation-url Source code on GitHub

Usage

Work in progress
 Section under construction.

Use Cases, Examples

The patient size correction factors are summarized here, where weight is in kilograms and height is in centimeters.

  • SUVbw:
    • males & females: weight
  • SUVlbm:
    • males: 1.10 * weight - 128 * (weight/height)^2
    • females: 1.07 * weight - 148 * (weight/height)^2
  • SUVbsa:
    • males & females: weight^0.425 * height^0.725 * 0.007184
  • SUVibw:
    • males: 48.0 + 1.06 * (height - 152)
    • females: 45.5 + 0.91 * (height - 152)

Tutorials

Quick Tour of Features and Use

A list of panels in the interface, their features, what they mean, and how to use them.

  • Input Image:
    • PET DICOM volume path [----petDICOMPath] [--p]: Input path to a directory containing a PET DICOM series with header information for SUV computation
  • Output:
    • RWV mapping object DICOM volume path [----rwvmDICOMPath] [--r]: Output path to a directory to store the RWV object with the SUV computation result
    • Radioactivity Units : DICOM Tag (0054,1001) - Radioactivity Units
    • Weight Units : Patient weight units (always assumed to be kg)
    • Height Units : Patient weight units (always assumed to be meters)
    • Volume Units : Volume units for concentration (always assumed to be mL)
    • Injected Dose : DICOM Tag (0018,1074) - Radionuclide Total Dose
    • Patient Weight : DICOM Tag (0010,1030) - Patient Weight
    • Patient Height : DICOM Tag (0010,1020) - Patient Size
    • Patient Sex : DICOM Tag (0010,0040) - Patient Sex
    • Series Reference Time : DICOM Tag (0008,0031) - Series Time
    • Injection Time : DICOM Tag (0018,1072) - Radiopharmaceutical Start Time
    • Decay Correction : DICOM Tag (0054,1102) - Decay Correction
    • Decay Factor : DICOM Tag (0054,1321) - Decay Factor
    • Radionuclide Half-life : DICOM Tag (0018,1075) - Radionuclide Half-Life
    • Frame Reference Time : DICOM Tag (0054,1300) - Frame Reference Time
    • SUVbw Conversion Factor : Standardized Uptake Value (body weight) Conversion Factor
    • SUVlbm Conversion Factor : Standardized Uptake Value (lean body mass) Conversion Factor
    • SUVbsa Conversion Factor : Standardized Uptake Value (body surface area) Conversion Factor
    • SUVibw Conversion Factor : Standardized Uptake Value (ideal body weight) Conversion Factor
    • RWVM File : Real World Value Mapping object file
User Interface


Development

Work in progress
 Section under construction.

Notes from the Developer(s)

Tests

Information for Developers

Other Information

Acknowledgment

This work is funded in part by Quantitative Image Informatics for Cancer Research (QIICR) NIH grant U24 CA180918.

References

Sugawara et al. "Reevaluation of the Standardized Uptake Value for FDG: Variation with Body Weight and Methods for Correction." Radiology. 1999.
http://pubs.rsna.org/doi/pdf/10.1148/radiology.213.2.r99nv37521

Retrieved from "https://www.slicer.org/w/index.php?title=Documentation/Nightly/Modules/SUVFactorCalculator&oldid=38887"