Documentation/4.4/Modules/SUVFactorCalculator - Revision history

Chribaue at 20:05, 16 March 2015

2015-03-16T20:05:08Z

Ejulrich: update contributors, contact email, and images

2015-01-20T17:57:03Z

update contributors, contact email, and images

UpdateBot: Nightly -> 4.4

2014-12-25T06:52:11Z

Nightly -> 4.4

New page

<noinclude>{{documentation/versioncheck}}</noinclude>

{{documentation/{{documentation/version}}/module-header}}



==Introduction and Acknowledgements==
{{documentation/{{documentation/version}}/module-introduction-start|{{documentation/modulename}}}}
{{documentation/{{documentation/version}}/module-introduction-row}}
Acknowledgments:
This work is funded in part by [http://qiicr.org Quantitative Image Informatics for Cancer Research (QIICR)] NIH grant U24 CA180918. 
Authors: Andrey Fedorov ({{collaborator|name|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: [http://www.slicer.org/pages/LicenseText Slicer License]

{{documentation/{{documentation/version}}/module-introduction-row}}
{{documentation/{{documentation/version}}/module-introduction-logo-gallery
|{{collaborator|logo|qiicr}}|{{collaborator|longname|qiicr}}
|{{collaborator|logo|namic}}|{{collaborator|longname|namic}}
}}
{{documentation/{{documentation/version}}/module-introduction-end}}

== General Information ==
{{documentation/{{documentation/version}}/extension-developerinfo}}
===Module Type & Category===

Type: CLI

Category: Quantification

===Module Description===

{| style="color:gray" border="1"
|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 || [http://www.slicer.org/slicerWiki/index.php/Documentation/4.3/Modules/SUVFactorCalculator Source code] on GitHub
|-
|}

== Usage ==
{{documentation/{{documentation/version}}/extension-developerinfo}}
===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

|[[Image:SUV_Factor_Calculator_GUI.png|thumb|400px|User Interface]]
|}

== Development ==
{{documentation/{{documentation/version}}/extension-developerinfo}}
===Notes from the Developer(s)===
*

===Tests===
*
===Information for Developers===

*Source code: https://github.com/QIICR/Slicer-PETDICOMExtension/tree/master/SUVFactorCalculatorCLI

==Other Information==
===Acknowledgment===
This work is funded in part by [http://qiicr.org 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

@@ Line 9: / Line 9: @@
 {{documentation/{{documentation/version}}/module-introduction-row}}
 Acknowledgments:
-This work is funded in part by [http://imaging.cancer.gov/programsandresources/specializedinitiatives/qin/iowa Quantitative Imaging to Assess Response in Cancer Therapy Trials] NIH grant U01-CA140206 and [http://qiicr.org Quantitative Image Informatics for Cancer Research (QIICR)] NIH grant U24 CA180918. <br>
+The UIowa [http://imaging.cancer.gov/programsandresources/specializedinitiatives/qin  QIN] PET DICOM Extension was funded in part by [http://imaging.cancer.gov/programsandresources/specializedinitiatives/qin/iowa Quantitative Imaging to Assess Response in Cancer Therapy Trials] NIH grant U01-CA140206 and [http://qiicr.org Quantitative Image Informatics for Cancer Research (QIICR)] NIH grant U24 CA180918. <br>
 Authors: Andrey Fedorov ({{collaborator|name|spl}}), Ethan Ulrich (University of Iowa), Markus van Tol (University of Iowa)<br>
 Contributors: Christian Bauer (University of Iowa), Reinhard Beichel (University of Iowa), John Buatti (University of Iowa), Hans Johnson (University of Iowa), Wendy Plesniak (SPL, BWH), Nicole Aucoin (SPL, BWH), Ron Kikinis (SPL, BWH)<br>

@@ Line 9: / Line 9: @@
 {{documentation/{{documentation/version}}/module-introduction-row}}
 Acknowledgments:
-This work is funded in part by [http://qiicr.org Quantitative Image Informatics for Cancer Research (QIICR)] NIH grant U24 CA180918. <br>
+This work is funded in part by [http://imaging.cancer.gov/programsandresources/specializedinitiatives/qin/iowa Quantitative Imaging to Assess Response in Cancer Therapy Trials] NIH grant U01-CA140206 and [http://qiicr.org Quantitative Image Informatics for Cancer Research (QIICR)] NIH grant U24 CA180918. <br>
-Authors: Andrey Fedorov ({{collaborator|name|spl}}), Ethan Ulrich (University of Iowa)<br>
+Authors: Andrey Fedorov ({{collaborator|name|spl}}), Ethan Ulrich (University of Iowa), Markus van Tol (University of Iowa)<br>
-Contributors: Markus Van Tol (University of Iowa), Hans Johnson (University of Iowa), Wendy Plesniak (SPL, BWH), Nicole Aucoin (SPL, BWH), Ron Kikinis (SPL, BWH)<br>
+Contributors: Christian Bauer (University of Iowa), Reinhard Beichel (University of Iowa), John Buatti (University of Iowa), Hans Johnson (University of Iowa), Wendy Plesniak (SPL, BWH), Nicole Aucoin (SPL, BWH), Ron Kikinis (SPL, BWH)<br>
-Contact: Ethan Ulrich, <email>ethan-ulrich@uiowa.edu</email><br>
+Contact: <email>qin@iibi.uiowa.edu</email><br>
 License: [http://www.slicer.org/pages/LicenseText Slicer License]
@@ Line 18: / Line 18: @@
 {{documentation/{{documentation/version}}/module-introduction-row}}
 {{documentation/{{documentation/version}}/module-introduction-logo-gallery
 |{{collaborator|logo|qiicr}}|{{collaborator|longname|qiicr}}
 |{{collaborator|logo|namic}}|{{collaborator|longname|namic}}
@@ Line 24: / Line 25: @@
 == General Information ==
-{{documentation/{{documentation/version}}/extension-developerinfo}}
 ===Module Type & Category===
@@ Line 38: / Line 39: @@
 |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 || [http://www.slicer.org/slicerWiki/index.php/Documentation/4.3/Modules/SUVFactorCalculator Source code] on GitHub
+|Program documentation-url || [https://github.com/QIICR/Slicer-PETDICOMExtension/tree/master/SUVFactorCalculatorCLI Source code] on GitHub
 |-
 |}
 == Usage ==
-{{documentation/{{documentation/version}}/extension-developerinfo}}
 ===Use Cases, Examples===
 The patient size correction factors are summarized here, where weight is in kilograms and height is in centimeters.
@@ Line 113: / Line 114: @@
 == Development ==
 {{documentation/{{documentation/version}}/extension-developerinfo}}
 ===Information for Developers===
 *Source code: https://github.com/QIICR/Slicer-PETDICOMExtension/tree/master/SUVFactorCalculatorCLI
 ===References===