read.DVH: Read DVH data from input file

Description

Function to extract DVH data from input file(s). Supported file formats include Aria (v8-13), DICOM-RT, CadPlan, Monaco, RayStation, and TomoTherapy.

Usage

read.DVH(file, type=NA, verbose=TRUE, collapse=TRUE, modality=NULL, encoding="latin1")

Value

Returns a single DVH.list object containing all DVH information from a single input file. If multiple files are specified, a list of DVH.list objects will be returned.

Arguments

file: Location of file containing relevant DVH information. One or more files may be specified. If multiple files are specified, all will be imported simultaneously.
type: Character vector specifying the DVH file format corresonding to each element in file. Value(s) must be one of "aria8", "aria10", "aria11", "aria13", "aria15", "dicom", "cadplan", "monaco", "raystation", or "tomo" (default is NA, which will attempt to guess the appropriate file type for each DVH file). Note that multiple different types can be processed so long as the length of type corresponds to the number of files specified, or otherwise type=NA.
verbose: Single logical value indicating whether or not to output verbose information and status in text
collapse: Single logical value indicating whether or not to collapse input from multiple files into a single DVH.list with all structures (default) or to output a nested list of individual DVH.list objects with each one corresponding to a single input file
modality: When type="dicom", this parameter is used to specify the scan type expected in importing DICOM-RT data (must be one one of "CT" [default] or "MR").
encoding: Character value specifying the encoding type for the DVH file (default is "latin1").

Author

Reid F. Thompson (reid.thompson@gmail.com)

Examples

Run this code

# Read two DVH example files
file1 <- system.file("extdata/John_Doe.dvh", package="RadOnc")
johndoe <- read.DVH(file=file1, type="aria10", verbose=TRUE)
file2 <- system.file("extdata/Jane_Doe.dvh", package="RadOnc")
janedoe <- read.DVH(file=file2, type="aria10", verbose=TRUE)
combined <- read.DVH(file=c(file1, file2), type="aria10", collapse=TRUE)