Documentation/Nightly/Modules/SUVFactorCalculator - Revision history

Chribaue: /* SUV normalization factor calculation - Required metadata */

2022-04-08T21:03:03Z

SUV normalization factor calculation - Required metadata

Chribaue: /* SUV normalization factor calculation */

2022-04-08T20:05:14Z

SUV normalization factor calculation

Chribaue: /* SUV normalization factor calculation */

2022-04-08T20:04:29Z

SUV normalization factor calculation

Chribaue: added info about required DICOM metadata for SUV factor calculation

2022-04-08T20:03:15Z

added info about required DICOM metadata for SUV factor calculation

Chribaue: updated general information and added command line usage

2022-03-16T18:19:14Z

updated general information and added command line usage

Show changes

Chribaue at 16:39, 16 March 2022

2022-03-16T16:39:58Z

Chribaue: updated SUVFactorCLI module description

2022-03-16T16:33:03Z

updated SUVFactorCLI module description

Chribaue at 20:03, 16 March 2015

2015-03-16T20:03:11Z

Ejulrich: update contact email

2015-01-19T18:46:47Z

update contact email

Ejulrich: fix source code link

2015-01-16T19:05:50Z

fix source code link

@@ Line 119: / Line 119: @@
 *(0028,0051) '''CorrectedImage must contain ATTN and DECAY or DECY'''
 *(0054,0016) '''RadiopharmaceuticalInformationSequence'''
-*(0018,1072) RadiopharmaceuticalStartTime or (0018,1078) RadiopharmaceuticalStartDateTime
+**(0018,1072) RadiopharmaceuticalStartTime or (0018,1078) RadiopharmaceuticalStartDateTime
-*(0018,1074) RadionuclideTotalDose
+**(0018,1074) RadionuclideTotalDose
-*(0018,1075) RadionuclideHalfLife
+**(0018,1075) RadionuclideHalfLife
 *(0054,1001) '''Units must be BQML, *Bq, or *Ci'''
 *(0054,1002) '''DecayCorrection must be START'''

@@ Line 102: / Line 102: @@
 |}
-==SUV normalization factor calculation==
+==SUV normalization factor calculation - Required metadata==
 {|

@@ Line 41: / Line 41: @@
 **females: 45.5 + 0.91 * (height - 152)
-== Use cases ==
+==Use cases==
 The CLI can be used directly as shown below, but its functionality also integrates into Slicer's DICOM browser GUI via the Sicer [[Documentation/Nightly/Extensions/PETDICOM|PET DICOM Extension]]'s [[Documentation/{{documentation/version}}/Modules/DICOMRWVMPlugin|DICOM Real World Value Mapping Plugin]] and [[Documentation/{{documentation/version}}/Modules/DICOMPETSUVPlugin|DICOM PET SUV Plugin]].
@@ Line 58: / Line 58: @@
 </syntaxhighlight>A complete list of all parameters is provided in the Module Panel description below.
-== Module Panel ==
+==Module Panel==
 Parameters:
 {|
@@ Line 105: / Line 105: @@
 {|
-|[[File:PET_DICOM_metadata.png|thumb|500px|DICOM metadata requires for SUV normalization. green: requires for all SUV normalization factors, orange: only required for SUVlbm, SUVbsa, and SUVibw.]]
+|[[File:PET_DICOM_metadata.png|thumb|500px|DICOM metadata required for SUV normalization. Green: required for all SUV normalization factors. Orange: only required for SUVlbm, SUVbsa, and SUVibw.]]
-−
 SUV normalization factor computation is based on the vendor-neutral "happy path only" calculation described on the Quantitative Imaging Biomarkers Alliance (QIBA) wiki page [https://qhttps://qibawiki.rsna.org/index.php/Standardized_Uptake_Value_(SUV)#SUV_Calculation Standardized Uptake Value (SUV)].
 The following set of '''DICOM tags with proper values are required''' in the PET DICOM files to calculate SUV normalization factors:
 *(0008,0021) SeriesDate
 *(0008,0022) AcquisitionDate
@@ Line 127: / Line 128: @@
 For calculation of SUVlbm, SUVbsa, and SUVibw in addition:
 * (0010,0040) PatientSex in (M,F)
-* (0010,1020) PatientSize >0
+*(0010,0040) PatientSex in (M,F)
 One can check the existence and values of these DICOM tags, using Slicer's DICOM browser, by selecting "View DICOM metadata" from the PET series' context menu:
@@ Line 144: / Line 146: @@
 Sugawara et al. "Reevaluation of the Standardized Uptake Value for FDG: Variation with Body Weight and Methods for Correction." Radiology. 1999.<br>
 http://pubs.rsna.org/doi/pdf/10.1148/radiology.213.2.r99nv37521

@@ Line 101: / Line 101: @@
 |[[File:SUV_Factor_Calculator_GUI_2022.png|thumb|400px|User Interface]]
 |}
 ==Information for Developers==

@@ Line 101: / Line 101: @@
 ** <span style="color:green">'''SUVibw Volume<'''</span> [<span style="color:orange">----SUVibw</span>]: Output file path for SUVibw normalized volume.
-|[[File:SUV Factor Calculator GUI 2022.png|thumb|400px|User Interface]]
+|[[File:SUV_Factor_Calculator_GUI_2022.png|thumb|400px|User Interface]]
 |}

@@ Line 66: / Line 66: @@
 * <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>]: 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">'''''SUV Factor Information'''''</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>: DICOM Tag (0054,1001) - Radioactivity Units
-** <span style="color:green">'''Radioactivity Units'''</span>  : DICOM Tag (0054,1001) - Radioactivity Units
+* <span style="color:blue">'''''Real World Value Mapping'''''</span>:
-** <span style="color:green">'''Weight Units'''</span>  : Patient weight units (always assumed to be kg)
+* <span style="color:blue">'''''SUV Normalized Images'''''</span>:
-** <span style="color:green">'''Height Units'''</span>  : Patient weight units (always assumed to be meters)
+|[[File:SUV Factor Calculator GUI 2022.png|thumb|400px|User Interface]]
 |}

@@ 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 12: / Line 12: @@
 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>
-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 39: / 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
 |-
 |}