Reads in the DICOM header from a file

read_dicom_header(
  file = "*.dcm",
  replace_names = FALSE,
  add_opts = "",
  recursive = FALSE,
  path = ".",
  fail_on_nonzero_exit = FALSE,
  ...
)

read_single_dicom_header(
  file = "",
  replace_names = FALSE,
  add_opts = "",
  fail_on_nonzero_exit = FALSE,
  ...
)

dcmhd(...)

Arguments

file

DICOM input file or directory. If recursivee = TRUE, then this will be the pattern to match within path

replace_names

logical indicating if unknown tag names should be inferred from dicom_tags

add_opts

additional options to pass to dcmdump. The flags already added are -q --print-all --load-short --print-filename

recursive

logical indicating if the --recurse flag be passed to dcmdump

path

if recursive = TRUE, then this will the path scanned.

fail_on_nonzero_exit

should a non-zero exit status on `dcmdump` cause an error (`TRUE`) or a warning (`FALSE`)?

...

passed to dcmdump

Value

Character vector of header information

Examples

file = system.file("extdata", "example.dcm", package = "dcmtk")
read_dicom_header(file)
#> Error in check_dcmtk_cmd(cmd): DCMTK command dcmdump not found! If DCMTK not installed system wide, see info https://dicom.offis.de/en/dcmtk/dcmtk-tools/!