1drtdump(1)                        OFFIS DCMTK                       drtdump(1)
2
3
4

NAME

6       drtdump - Dump DICOM RT file and data set
7
8

SYNOPSIS

10       drtdump [options] drtfile-in...
11

DESCRIPTION

13       The  drtdump  utility  dumps  the contents of a DICOM Radiation Therapy
14       (RT) object (file format or raw data set) to stdout  in  textual  form.
15       The  output  consists  of  essential  information on the RT object in a
16       format that is probably easier to read than the more generic  one  from
17       dcmdump.
18
19       If drtdump reads a raw data set (DICOM data without a file format meta-
20       header) it will attempt to guess the transfer syntax by  examining  the
21       first  few  bytes  of  the file. It is not always possible to correctly
22       guess the transfer syntax and it is better to convert a data set  to  a
23       file  format  whenever possible (using the dcmconv utility). It is also
24       possible to use the -f and -t[ieb] options to force drtdump to  read  a
25       dataset with a particular transfer syntax.
26

PARAMETERS

28       drtfile-in  DICOM RT input filename to be dumped
29

OPTIONS

31   general options
32         -h   --help
33                print this help text and exit
34
35              --version
36                print version information and exit
37
38              --arguments
39                print expanded command line arguments
40
41         -q   --quiet
42                quiet mode, print no warnings and errors
43
44         -v   --verbose
45                verbose mode, print processing details
46
47         -d   --debug
48                debug mode, print debug information
49
50         -ll  --log-level  [l]evel: string constant
51                (fatal, error, warn, info, debug, trace)
52                use level l for the logger
53
54         -lc  --log-config  [f]ilename: string
55                use config file f for the logger
56
57   input options
58       input file format:
59
60         +f   --read-file
61                read file format or data set (default)
62
63         +fo  --read-file-only
64                read file format only
65
66         -f   --read-dataset
67                read data set without file meta information
68
69       input transfer syntax:
70
71         -t=  --read-xfer-auto
72                use TS recognition (default)
73
74         -td  --read-xfer-detect
75                ignore TS specified in the file meta header
76
77         -te  --read-xfer-little
78                read with explicit VR little endian TS
79
80         -tb  --read-xfer-big
81                read with explicit VR big endian TS
82
83         -ti  --read-xfer-implicit
84                read with implicit VR little endian TS
85
86   output options
87       printing:
88
89         +Pf  --print-filename
90                print header with filename for each input file
91

NOTES

93   DICOM Conformance
94       The drtdump utility supports the following SOP Classes:
95
96       RTImageStorage                   1.2.840.10008.5.1.4.1.1.481.1
97       RTDoseStorage                    1.2.840.10008.5.1.4.1.1.481.2
98       RTStructureSetStorage            1.2.840.10008.5.1.4.1.1.481.3
99       RTPlanStorage                    1.2.840.10008.5.1.4.1.1.481.5
100       RTTreatmentSummaryRecordStorage  1.2.840.10008.5.1.4.1.1.481.7
101       RTIonPlanStorage                 1.2.840.10008.5.1.4.1.1.481.8
102       RTIonBeamsTreatmentRecordStorage 1.2.840.10008.5.1.4.1.1.481.9
103

LOGGING

105       The  level  of  logging  output  of  the various command line tools and
106       underlying libraries can be specified by the  user.  By  default,  only
107       errors  and  warnings  are  written to the standard error stream. Using
108       option --verbose also informational messages  like  processing  details
109       are  reported.  Option  --debug  can be used to get more details on the
110       internal activity, e.g. for debugging purposes.  Other  logging  levels
111       can  be  selected  using option --log-level. In --quiet mode only fatal
112       errors are reported. In such very severe error events, the  application
113       will  usually  terminate.  For  more  details  on the different logging
114       levels, see documentation of module 'oflog'.
115
116       In case the logging output should be written to file  (optionally  with
117       logfile  rotation),  to syslog (Unix) or the event log (Windows) option
118       --log-config can be used.  This  configuration  file  also  allows  for
119       directing  only  certain messages to a particular output stream and for
120       filtering certain messages based on the  module  or  application  where
121       they  are  generated.  An  example  configuration  file  is provided in
122       <etcdir>/logger.cfg.
123

COMMAND LINE

125       All command line tools  use  the  following  notation  for  parameters:
126       square  brackets  enclose  optional  values  (0-1), three trailing dots
127       indicate that multiple values are allowed (1-n), a combination of  both
128       means 0 to n values.
129
130       Command line options are distinguished from parameters by a leading '+'
131       or '-' sign, respectively. Usually, order and position of command  line
132       options  are  arbitrary  (i.e.  they  can appear anywhere). However, if
133       options are mutually exclusive the rightmost appearance is  used.  This
134       behavior  conforms  to  the  standard  evaluation  rules of common Unix
135       shells.
136
137       In addition, one or more command files can be specified  using  an  '@'
138       sign  as  a  prefix to the filename (e.g. @command.txt). Such a command
139       argument is replaced by the content  of  the  corresponding  text  file
140       (multiple  whitespaces  are  treated  as a single separator unless they
141       appear between two quotation marks) prior to  any  further  evaluation.
142       Please  note  that  a command file cannot contain another command file.
143       This simple but effective  approach  allows  one  to  summarize  common
144       combinations  of  options/parameters  and  avoids longish and confusing
145       command lines (an example is provided in file <datadir>/dumppat.txt).
146

ENVIRONMENT

148       The drtdump utility  will  attempt  to  load  DICOM  data  dictionaries
149       specified  in the DCMDICTPATH environment variable. By default, i.e. if
150       the  DCMDICTPATH  environment   variable   is   not   set,   the   file
151       <datadir>/dicom.dic  will be loaded unless the dictionary is built into
152       the application (default for Windows).
153
154       The  default  behavior  should  be  preferred   and   the   DCMDICTPATH
155       environment  variable  only used when alternative data dictionaries are
156       required. The DCMDICTPATH environment variable has the same  format  as
157       the  Unix  shell PATH variable in that a colon (':') separates entries.
158       On Windows systems, a semicolon (';') is used as a separator. The  data
159       dictionary  code  will  attempt  to  load  each  file  specified in the
160       DCMDICTPATH environment variable. It is an error if no data  dictionary
161       can be loaded.
162

SEE ALSO

164       dcmconv(1), dcmdump(1)
165
167       Copyright (C) 2010-2022 by OFFIS e.V. and ICSMED AG, Escherweg 2, 26121
168       Oldenburg, Germany.
169
170
171
172Version 3.6.7                   Fri Apr 22 2022                     drtdump(1)
Impressum