divest (version 1.1.1)

imageAttributes: Extended image attributes

Description

These functions extract and replace medical image attributes that go beyond the core metadata associated with the NIfTI-1 file format.

Usage

imageAttributes(x)
imageAttributes(x) <- value

Value

A list of image attributes, or a modified object with these changed. These are essentially all attributes except those used for basic niftiImage objects by the RNifti package.

Arguments

x

An R object, generally an image object like those returned by readDicom.

value

A list of new image attributes to replace any existing ones.

Author

Jon Clayden

Details

The DICOM format can encapsulate copious amounts of metadata about the scan and the patient, which can be useful for more advanced or research-focussed post-processing methods. Some of this information is extracted during the DICOM-to-NIfTI conversion process and stored in additional named attributes; the imageAttributes function returns a list of just these extended attributes. The replacement form allows this metadata to be modified or removed. These functions currently only act on objects inheriting from the niftiImage class.

References

More information about metadata captured by the BIDS format can be found at https://bids.neuroimaging.io or in the paper cited below.

K.J. Gorgolewski, T. Auer, V.D. Calhoun, et al. The brain imaging data structure, a format for organizing and describing outputs of neuroimaging experiments (2016). Scientific Data 3:160044. tools:::Rd_expr_doi("10.1038/sdata.2016.44").

Examples

path <- system.file("extdata", "raw", package="divest")
images <- readDicom(path, interactive=FALSE)
imageAttributes(images[[1]])