Difference between revisions of "Documentation/Nightly/Modules/SUVFactorCalculator"
(updated general information and added command line usage) |
(added info about required DICOM metadata for SUV factor calculation) Tag: 2017 source edit |
||
Line 101: | Line 101: | ||
|[[File:SUV_Factor_Calculator_GUI_2022.png|thumb|400px|User Interface]] | |[[File:SUV_Factor_Calculator_GUI_2022.png|thumb|400px|User Interface]] | ||
|} | |} | ||
+ | |||
+ | ==SUV normalization factor calculation== | ||
+ | |||
+ | {| | ||
+ | |[[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.]] | ||
+ | } | ||
+ | |||
+ | 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 | ||
+ | *(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: | ||
+ | |||
+ | {| | ||
+ | |[[File:DICOM_metadata_contextmenu.png|thumb|400px|To display a PET scans DICOM metadata, select "View DICOM metadata" from the series' context menu in the DICOM browser.]] | ||
+ | |} | ||
+ | |||
==Information for Developers== | ==Information for Developers== | ||
Revision as of 20:03, 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. License: Slicer License | |||||||
|
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:
|
SUV normalization factor calculation
} 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:
For calculation of SUVlbm, SUVbsa, and SUVibw in addition:
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: Information for DevelopersReferencesSugawara et al. "Reevaluation of the Standardized Uptake Value for FDG: Variation with Body Weight and Methods for Correction." Radiology. 1999. |