get.HU {RadOnc}

Extract Hounsfield Unit (HU) data for one or more structure(s) from a CT image

Description

Function to extract Hounsfield Unit (HU) data for one or more structure(s) from a CT image.

Usage

## S4 method for signature 'RTdata,missing'
get.HU(x, CT, resolution.xyz=NA,	resolution.HU=1, method=NULL)

## S4 method for signature 'structure3D,array'
get.HU(x, CT, resolution.xyz=NA, resolution.HU=1, method=NULL)

## S4 method for signature 'structure.list,array'
get.HU(x, CT, resolution.xyz=NA, resolution.HU=1, method=NULL)

Arguments

x

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

CT

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

resolution.xyz

A numeric list containing three positive values representing x, y, and z resolution to be used for Hounsfield Unit (HU) interpolation from CT imaging data (specified in units of mm). The smaller each value, the longer the overall calculation time (default is c(NA, NA, NA) which is interpreted as the native CT image resolution). z resolution defaults to axial slice thickness when method="axial".

resolution.HU

A positive numeric value specifying the HU calculation interval (bin width) for histogram calculation.

method

Character value specifying the Hounsfield Unit (HU) calculation algorithm to employ. Must be NULL or "axial".

Value

Returns a single calculated "histogram" object or a "list" of "histogram" objects consisting of Hounsfield Unit values contained within the input "structure3D" or "structure.list", respectively.

Author(s)

Reid F. Thompson ([e-mail])

See Also

RTdata, hist