Difference between revisions of "Documentation/Nightly/Modules/SUVFactorCalculator"
(updated SUVFactorCLI module description) Tag: 2017 source edit |
|||
Line 66: | Line 66: | ||
* <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>]: Input path to a directory containing a PET DICOM series with header information for SUV computation | ** <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:green">'''Instance UID of PET series'''</span> [<span style="color:orange">----petSeriesInstanceUID</span>]: Instance UID of PET series (if multiple series in PET dicom path) | ||
− | * <span style="color:blue">''''' | + | * <span style="color:blue">'''''SUV Factor Information'''''</span>: |
− | ** <span style="color:green">''' | + | ** <span style="color:green">'''Radioactivity Units'''</span>: DICOM Tag (0054,1001) - Radioactivity Units |
+ | ** <span style="color:green">'''Weight Units'''</span>: Patient weight units (always assumed to be kg) | ||
+ | ** <span style="color:green">'''Height Units'''</span>: Patient weight units (always assumed to be meters) | ||
+ | ** <span style="color:green">'''Volume Units'''</span>: Volume units for concentration (always assumed to be mL) | ||
+ | ** <span style="color:green">'''Injected Dose'''</span>: DICOM Tag (0018,1074) - Radionuclide Total Dose | ||
+ | ** <span style="color:green">'''Patient Weight'''</span>: DICOM Tag (0010,1030) - Patient Weight | ||
+ | ** <span style="color:green">'''Patient Height'''</span>: DICOM Tag (0010,1020) - Patient Size | ||
+ | ** <span style="color:green">'''Patient Sex'''</span>: DICOM Tag (0010,0040) - Patient Sex | ||
+ | ** <span style="color:green">'''Series Reference Time'''</span>: DICOM Tag (0008,0031) - Series Time | ||
+ | ** <span style="color:green">'''Injection Time'''</span>: DICOM Tag (0018,1072) - Radiopharmaceutical Start Time | ||
+ | ** <span style="color:green">'''Decay Correction'''</span>: DICOM Tag (0054,1102) - Decay Correction | ||
+ | ** <span style="color:green">'''Decay Factor'''</span>: DICOM Tag (0054,1321) - Decay Factor | ||
+ | ** <span style="color:green">'''Radionuclide Half-life'''</span>: DICOM Tag (0018,1075) - Radionuclide Half-Life | ||
+ | ** <span style="color:green">'''Frame Reference Time'''</span>: DICOM Tag (0054,1300) - Frame Reference Time | ||
+ | ** <span style="color:green">'''SUVbw Conversion Factor'''</span>: Standardized Uptake Value (body weight) Conversion Factor | ||
+ | ** <span style="color:green">'''SUVlbm Conversion Factor'''</span>: Standardized Uptake Value (lean body mass) Conversion Factor | ||
+ | ** <span style="color:green">'''SUVbsa Conversion Factor'''</span>: Standardized Uptake Value (body surface area) Conversion Factor | ||
+ | ** <span style="color:green">'''SUVibw Conversion Factor'''</span>: Standardized Uptake Value (ideal body weight) Conversion Factor | ||
− | ** <span style="color:green">''' | + | * <span style="color:blue">'''''Real World Value Mapping'''''</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. Only used if no file name is provided. | ||
+ | ** <span style="color:green">'''RWVM DICOM object file'''</span> [<span style="color:orange">----rwvmDICOMFile</span>] [<span style="color:pink">--f</span>]: File name of the RWV object with the SUV computation result. Not required, default is the the DICOM instance UID. | ||
+ | ** <span style="color:green">'''Series description'''</span> [<span style="color:orange">----seriesDescription</span>]: Description for the generated RVW object. | ||
+ | ** <span style="color:green">'''Series Number'''</span> [<span style="color:orange">----seriesNumber</span>]: Series number for the generated RVW object. | ||
+ | ** <span style="color:green">'''Instance number'''</span> [<span style="color:orange">----instanceNumber</span>]: Instance number for the generated RVW object. | ||
− | ** <span style="color:green">''' | + | * <span style="color:blue">'''''SUV Normalized Images'''''</span>: |
+ | ** <span style="color:green">'''SUVbw Volume<'''</span> [<span style="color:orange">----SUVbw</span>]: Output file path for SUVbw normalized volume. | ||
+ | ** <span style="color:green">'''SUVlbm Volume<'''</span> [<span style="color:orange">----SUVlbm</span>]: Output file path for SUVlbm normalized volume. | ||
+ | ** <span style="color:green">'''SUVbsa Volume<'''</span> [<span style="color:orange">----SUVbsa</span>]: Output file path for SUVbsa normalized volume. | ||
+ | ** <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]] | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |[[ | ||
|} | |} | ||
Revision as of 16:33, 16 March 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
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
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.
|
Development
Section under construction. |
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