RadOnc (version 1.0.6)

calculate.DVH: Calculate DVH data for one or more structure(s) using a dose grid

Description

Function to calculate DVH data for one or more structure(s) using a dose grid.

Usage

## S3 method for class 'RTdata,missing':
calculate.DVH(x, dose, resolution.xyz=c(0.2,0.2,NA), 
	resolution.dose=0.01, method=c("ATC", "surface"), dose.units=c("cGy","Gy"))
## S3 method for class 'RTdata,array':
calculate.DVH(x, dose, resolution.xyz=c(0.2,0.2,NA), 
	resolution.dose=0.01, method=c("ATC", "surface"), dose.units=c("cGy","Gy"))
## S3 method for class 'structure3D,array':
calculate.DVH(x, dose, resolution.xyz=c(0.2,0.2,NA), 
	resolution.dose=0.01, method=c("ATC", "surface"), dose.units=c("cGy","Gy"))
## S3 method for class 'structure.list,array':
calculate.DVH(x, dose, resolution.xyz=c(0.2,0.2,NA), 
	resolution.dose=0.01, method=c("ATC", "surface"), dose.units=c("cGy","Gy"))

Arguments

x

One of either a "structure3D" object, a "structure.list", or a "RTdata" object containing one or more structure(s).

dose

Object of class "array" containing dose grid data. This parameter is not required if x contains a "RTdata" object including dose grid information.

resolution.xyz

A numeric list containing three positive values representing x, y, and z resolution to be used for DVH calculation (specified in units of mm). The smaller each value, the longer the overall calculation time (default is c(

resolution.dose

A positive numeric value specifying the dose calculation interval (bin width) for DVH calculation (values interpreted in Gy).

method

Character value specifying the DVH calculation algorithm to employ. Must be one of "ATC" or "surface". See below for further details about the dose calculation algorithms.

dose.units

Value specifying units of dose. Must be one of "cGy" (default) or "Gy".

Value

• Returns a single calculated "DVH" object or a "DVH.list" object consisting of multiple DVHs where relevant.

References

Straube, W., Matthews, J., Bosch, W., and Purdy, J.A. (2005) DVH Analysis: Consequences for Quality Assurance of Multi-Institutional Clinical Trials. Med Phys 32(6):2021.

See Also

DVH, DVH.list, new

Examples

# Read two DVH example files
# need to add DICOM data to RadOnc.RData so have a dose grid in there!!
# add further details section to discuss algorithm!!  should also have citation for ATC stuff!!