xlsx.from.dcm: Converting DICOM files to .xlsx files

In espadon: Easy Study of Patient DICOM Data in Oncology

Converting DICOM files to .xlsx files

Description

The xlsx.from.dcm function creates an Excel file from DICOM files.

Usage

xlsx.from.dcm(
  dcm.filenames,
  xlsx.filenames,
  multipage = TRUE,
  txt.sep = "\\",
  txt.length = 100,
  tag.dictionary = dicom.tag.dictionary()
)

Arguments

dcm.filenames	String vector, representing the list of full names of DICOM files.
xlsx.filenames	String vector, representing the list of full names of created *.xlsx files. If multipage = TRUE, only the xlsx.filenames[1] is used.
multipage	Boolean. If TRUE, all dcm.filenames are converted into multiple pages of the same *.xlsx file.
txt.sep	String. Used if as.txt = TRUE. Separator of the tag value elements.
txt.length	Positive integer. Used if as.txt = TRUE. Maximum number of letters in the representation of the TAG value.
tag.dictionary	Dataframe, by default equal to dicom.tag.dictionary, whose structure it must keep. This dataframe is used to parse DICOM files.

Value

Returns a boolean vector, establishing the existence of the created Excel files.

Examples

# First, save toy.dicom.raw () raw data to a temporary file pat.dir for testing.
pat.dir <- file.path (tempdir(), "PM_dcm") 
dir.create (pat.dir, recursive = TRUE) 
dcm.filename <- tempfile (pattern = "PMrtplan", tmpdir = pat.dir, fileext = ".dcm")
zz <- file (dcm.filename, "wb")
writeBin (toy.dicom.raw (), zz, size = 1)
close (zz)
list.files (pat.dir)

# Creating an Excel file
xlsx.fnames <- file.path (pat.dir, 
                          paste (basename (dcm.filename),"xlsx", sep = "."))
xlsx.from.dcm (dcm.filename, xlsx.fnames)
list.files (pat.dir)

# Cleaning temporary directory
unlink (pat.dir, recursive = TRUE)

espadon documentation built on April 11, 2025, 5:57 p.m.