1dcmdrle(1) OFFIS DCMTK dcmdrle(1)
2
6 dcmdrle - Decode RLE-compressed DICOM file
7
10 dcmdrle [options] dcmfile-in dcmfile-out
11
13 The dcmdrle utility reads a RLE-compressed DICOM image (dcmfile-in),
14 decompresses the image data (i.e. conversion to a native DICOM transfer
15 syntax) and writes the converted image to an output file (dcmfile-out).
16
18 dcmfile-in DICOM input filename to be converted
19 dcmfile-out DICOM output filename
21
23 general options
24 -h --help
25 print this help text and exit
26 --version
28 print version information and exit
29 --arguments
31 print expanded command line arguments
32 -q --quiet
34 quiet mode, print no warnings and errors
35 -v --verbose
37 verbose mode, print processing details
38 -d --debug
40 debug mode, print debug information
41 -ll --log-level [l]evel: string constant
43 (fatal, error, warn, info, debug, trace)
44 use level l for the logger
45 -lc --log-config [f]ilename: string
47 use config file f for the logger
48 input options
50 input file format:
51 +f --read-file
53 read file format or data set (default)
54 +fo --read-file-only
56 read file format only
57 -f --read-dataset
59 read data set without file meta information
60 # This option allows one to decompress RLE compressed DICOM objects that have
62 # been stored as dataset without meta-header. Such a thing should not exist
63 # since the transfer syntax cannot be reliably determined without meta-header,
64 # but unfortunately it does.
65 processing options
67 SOP Instance UID:
68 +ud --uid-default
70 keep same SOP Instance UID (default)
71 +ua --uid-always
73 always assign new UID
74 RLE byte segment order:
76 +bd --byte-order-default
78 most significant byte first (default)
79 +br --byte-order-reverse
81 least significant byte first
82 # This option allows one to decompress RLE compressed DICOM files in which
84 # the order of byte segments is encoded in incorrect order. This only affects
85 # images with more than one byte per sample.
86 output options
88 output file format:
89 +F --write-file
91 write file format (default)
92 -F --write-dataset
94 write data set without file meta information
95 output transfer syntax:
97 +te --write-xfer-little
99 write with explicit VR little endian (default)
100 +tb --write-xfer-big
102 write with explicit VR big endian TS
103 +ti --write-xfer-implicit
105 write with implicit VR little endian TS
106 post-1993 value representations:
108 +u --enable-new-vr
110 enable support for new VRs (UN/UT) (default)
111 -u --disable-new-vr
113 disable support for new VRs, convert to OB
114 group length encoding:
116 +g= --group-length-recalc
118 recalculate group lengths if present (default)
119 +g --group-length-create
121 always write with group length elements
122 -g --group-length-remove
124 always write without group length elements
125 length encoding in sequences and items:
127 +e --length-explicit
129 write with explicit lengths (default)
130 -e --length-undefined
132 write with undefined lengths
133 data set trailing padding (not with --write-dataset):
135 -p= --padding-retain
137 do not change padding (default if not --write-dataset)
138 -p --padding-off
140 no padding (implicit if --write-dataset)
141 +p --padding-create [f]ile-pad [i]tem-pad: integer
143 align file on multiple of f bytes
144 and items on multiple of i bytes
145
147 dcmdrle supports the following transfer syntaxes for input (dcmfile-
148 in):
149 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
151 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
152 DeflatedExplicitVRLittleEndianTransferSyntax 1.2.840.10008.1.2.1.99 (*)
153 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
154 RLELosslessTransferSyntax 1.2.840.10008.1.2.5
155 (*) if compiled with zlib support enabled
157 dcmdrle supports the following transfer syntaxes for output (dcmfile-
159 out):
160 LittleEndianImplicitTransferSyntax 1.2.840.10008.1.2
162 LittleEndianExplicitTransferSyntax 1.2.840.10008.1.2.1
163 BigEndianExplicitTransferSyntax 1.2.840.10008.1.2.2
164
166 The level of logging output of the various command line tools and
167 underlying libraries can be specified by the user. By default, only
168 errors and warnings are written to the standard error stream. Using
169 option --verbose also informational messages like processing details
170 are reported. Option --debug can be used to get more details on the
171 internal activity, e.g. for debugging purposes. Other logging levels
172 can be selected using option --log-level. In --quiet mode only fatal
173 errors are reported. In such very severe error events, the application
174 will usually terminate. For more details on the different logging
175 levels, see documentation of module 'oflog'.
176 In case the logging output should be written to file (optionally with
178 logfile rotation), to syslog (Unix) or the event log (Windows) option
179 --log-config can be used. This configuration file also allows for
180 directing only certain messages to a particular output stream and for
181 filtering certain messages based on the module or application where
182 they are generated. An example configuration file is provided in
183 <etcdir>/logger.cfg.
184
186 All command line tools use the following notation for parameters:
187 square brackets enclose optional values (0-1), three trailing dots
188 indicate that multiple values are allowed (1-n), a combination of both
189 means 0 to n values.
190 Command line options are distinguished from parameters by a leading '+'
192 or '-' sign, respectively. Usually, order and position of command line
193 options are arbitrary (i.e. they can appear anywhere). However, if
194 options are mutually exclusive the rightmost appearance is used. This
195 behavior conforms to the standard evaluation rules of common Unix
196 shells.
197 In addition, one or more command files can be specified using an '@'
199 sign as a prefix to the filename (e.g. @command.txt). Such a command
200 argument is replaced by the content of the corresponding text file
201 (multiple whitespaces are treated as a single separator unless they
202 appear between two quotation marks) prior to any further evaluation.
203 Please note that a command file cannot contain another command file.
204 This simple but effective approach allows one to summarize common
205 combinations of options/parameters and avoids longish and confusing
206 command lines (an example is provided in file <datadir>/dumppat.txt).
207
209 The dcmdrle utility will attempt to load DICOM data dictionaries
210 specified in the DCMDICTPATH environment variable. By default, i.e. if
211 the DCMDICTPATH environment variable is not set, the file
212 <datadir>/dicom.dic will be loaded unless the dictionary is built into
213 the application (default for Windows).
214 The default behavior should be preferred and the DCMDICTPATH
216 environment variable only used when alternative data dictionaries are
217 required. The DCMDICTPATH environment variable has the same format as
218 the Unix shell PATH variable in that a colon (':') separates entries.
219 On Windows systems, a semicolon (';') is used as a separator. The data
220 dictionary code will attempt to load each file specified in the
221 DCMDICTPATH environment variable. It is an error if no data dictionary
222 can be loaded.
223
225 dcmcrle(1)
226
228 Copyright (C) 2002-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
229 Germany
230Version 3.6.7 Fri Apr 22 2022 dcmdrle(1)