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

From Slicer Wiki
Jump to: navigation, search
(added info about required DICOM metadata for SUV factor calculation)
Tag: 2017 source edit
Line 41: Line 41:
 
**females: 45.5 + 0.91 * (height - 152)
 
**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]].
 
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.
 
</syntaxhighlight>A complete list of all parameters is provided in the Module Panel description below.
  
== Module Panel ==
+
==Module Panel==
 
Parameters:
 
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)].
 
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:
 
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,0021) SeriesDate​
 
*(0008,0022) AcquisitionDate​
 
*(0008,0022) AcquisitionDate​
Line 127: Line 128:
  
 
For calculation of SUVlbm, SUVbsa, and SUVibw in addition:
 
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) ​
 +
*(0010,1020) PatientSize >0
  
 
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:
 
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>
 
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
 
http://pubs.rsna.org/doi/pdf/10.1148/radiology.213.2.r99nv37521
 +
|}

Revision as of 20:04, 8 April 2022

Home < Documentation < Nightly < Modules < SUVFactorCalculator


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


Introduction and Acknowledgements

Acknowledgments: The UIowa QIN PET DICOM Extension 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: Andrey Fedorov (SPL), Ethan Ulrich (University of Iowa), Markus van Tol (University of Iowa), Christian Bauer (University of Iowa)
Contributors: 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)
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)  

General Information

The SUVFactorCalculator Command Line Interface (CLI) takes a PET DICOM series and computes Standardized Uptake Value conversion factors (SUVbw, SUBlbm, SUVbs, SUVibw). Those SUV factors can be stored in a DICOM Real World Value Mapping (RWVM) file and SUV normalized image volumes can be generated.

Depending on the information stored in the PET DICOM header, 4 types of SUV factors can be calculated as 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)

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 PET DICOM Extension's DICOM Real World Value Mapping Plugin and DICOM PET SUV Plugin.

Example command line usage:

# list program options
> SUVFactorCalculator --help

# read PET DICOM image series from folder and calculate SUV normalization factors
> SUVFactorCalculator -p pet_dicom_folder

# create RWVM DICOM file with calculated SUV normalization factors
> SUVFactorCalculator -p pet_dicom_folder -f rwvm.dcm

# create SUVbw normalized volume 
> SUVFactorCalculator -p pet_dicom_folder --SUVbw SUVbw.nrrd

A complete list of all parameters is provided in the Module Panel description below.

Module Panel

Parameters:

  • Input Image:
    • PET DICOM volume path [--petDICOMPath] [-p]: Input path to a directory containing a PET DICOM series with header information for SUV computation
    • Instance UID of PET series [--petSeriesInstanceUID]: Instance UID of PET series (if multiple series in PET dicom path)
  • SUV Factor Information:
    • 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
  • Real World Value Mapping:
    • RWV mapping object DICOM volume path [--rwvmDICOMPath] [-r]: Output path to a directory to store the RWV object with the SUV computation result. Only used if no file name is provided.
    • RWVM DICOM object file [--rwvmDICOMFile] [-f]: File name of the RWV object with the SUV computation result. Not required, default is the the DICOM instance UID.
    • Series description [--seriesDescription]: Description for the generated RVW object.
    • Series Number [--seriesNumber]: Series number for the generated RVW object.
    • Instance number [--instanceNumber]: Instance number for the generated RVW object.
  • SUV Normalized Images:
    • SUVbw Volume< [--SUVbw]: Output file path for SUVbw normalized volume.
    • SUVlbm Volume< [--SUVlbm]: Output file path for SUVlbm normalized volume.
    • SUVbsa Volume< [--SUVbsa]: Output file path for SUVbsa normalized volume.
    • SUVibw Volume< [--SUVibw]: Output file path for SUVibw normalized volume.
User Interface

SUV normalization factor calculation

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 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​
  • (0008,0031) SeriesTime​
  • (0008,0032) AcquisitionTime​
  • (0008,0060) Modality must be PT
  • (0010,1030) PatientWeight >0
  • (0028,0051) CorrectedImage must contain ATTN and DECAY or DECY​
  • (0054,0016) RadiopharmaceuticalInformationSequence​
  • (0018,1072) RadiopharmaceuticalStartTime or (0018,1078) RadiopharmaceuticalStartDateTime​
  • (0018,1074) RadionuclideTotalDose​
  • (0018,1075) RadionuclideHalfLife​
  • (0054,1001) Units must be BQML, *Bq, or *Ci​
  • (0054,1002) DecayCorrection must be START
  • (0054,1300) FrameReferenceTime​
  • (0054,1321) DecayFactor

For calculation of SUVlbm, SUVbsa, and SUVibw in addition:

  • (0010,0040) PatientSex in (M,F) ​
  • (0010,1020) PatientSize >0

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:

To display a PET scans DICOM metadata, select "View DICOM metadata" from the series' context menu in the DICOM browser.

Information for Developers

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