qiba: Calculating SUVs for PET Using QIBA Pseudocode
In oro.pet: Rigorous - Positron Emission Tomography

Description Usage Arguments Details Value Author(s) References See Also

The standard uptake value (SUV) is calculated based on an 18F-FDG-PET acquistion using ancillary information contained in the DICOM data.

## S4 method for signature 'array'
standardUptakeValue(pixelData, mask = NULL, CSV = NULL,
                    seriesNumber = NULL, method = c("qiba", "user"),
                    prior = NULL, decayedDose = NULL)
## S4 method for signature 'array'
activityConcentration(pixelData, CSV = NULL, seriesNumber = NULL,
                      method = "qiba")

`pixelData`	is a multidimensional array of signal intensities of class `nifti`.
`mask`	is a multidimensional array of logical values (only used when `method = "user"`).
`CSV`	is a `data.frame` that is the output from `dicomTable` and contains all necessary DICOM header fields.
`seriesNumber`	is the SeriesNumber that corresponds to the PET acquisition.
`method`	takes on two possible values (`qiba` and `user`), where QIBA pseudocode is used to calculate the SUVs or user-defined parameters are used.
`prior`	is a list of DICOM header field names that are necessary for the SUV calculation under `method = "user"` or may be used to replace values from the DICOM header information when `method = "qiba"`.
`decayedDose`	is the amount of the RadionuclideTotalDose after being corrected for residual dose in the syringe. This value is NOT usually corrected in the DICOM data.

[MORE]

Note, for GE scanners it is common for the RescaleSlope DICOM field to vary on a slice-by-slice basis. This is taken into account if a GE scanner is detected from the Modality DICOM field. However, the InstanceNumber is used to reorder the slices so they match the incoming NIfTI file of PixelData. If this is not correct it may be necessary to manually re-order the RescaleSlope field in the CSV data frame so that the activity concentration is calculated correctly.

A list containing the following items

`SUVbw`	is a multidimensional array, the same dimension as `pixelData`, that contains the standard uptake values.
`hdr`	is a list of DICOM header fields used in the SUV calculation.
`decayTime`	is the decay time calculated from the DICOM header information.
`decayedDose`	is the RadionuclideTotalDose, if taken from the DICOM header information, or the user-specified value.
`SUVbwScaleFactor`	is \mbox{PatientsWeight}\cdot1000/\mbox{decayedDose}.