1dcmconv(1) OFFIS DCMTK dcmconv(1)
2
6 dcmconv - Convert DICOM file encoding
7
10 dcmconv [options] dcmfile-in dcmfile-out
11
13 The dcmconv utility reads a DICOM file (dcmfile-in), performs an
14 encoding conversion and writes the converted data to an output file
15 (dcmfile-out).
16
18 dcmfile-in DICOM input filename to be converted
19 dcmfile-out DICOM output filename to write to
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 -l --log-level [l]evel: string constant
43 (fatal, error, warn, info, debug, trace)
44 use level l for the logger
45 -l --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 input transfer syntax:
62 -t= --read-xfer-auto
64 use TS recognition (default)
65 -td --read-xfer-detect
67 ignore TS specified in the file meta header
68 -te --read-xfer-little
70 read with explicit VR little endian TS
71 -tb --read-xfer-big
73 read with explicit VR big endian TS
74 -ti --read-xfer-implicit
76 read with implicit VR little endian TS
77 parsing of file meta information:
79 +ml --use-meta-length
81 use file meta information group length (default)
82 -ml --ignore-meta-length
84 ignore file meta information group length
85 parsing of odd-length attributes:
87 +ao --accept-odd-length
89 accept odd length attributes (default)
90 +ae --assume-even-length
92 assume real length is one byte larger
93 handling of explicit VR:
95 +ev --use-explicit-vr
97 use explicit VR from dataset (default)
98 -ev --ignore-explicit-vr
100 ignore explicit VR (prefer data dictionary)
101 handling of non-standard VR:
103 +vr --treat-as-unknown
105 treat non-standard VR as unknown (default)
106 -vr --assume-implicit
108 try to read with implicit VR little endian TS
109 handling of undefined length UN elements:
111 +ui --enable-cp246
113 read undefined len UN as implicit VR (default)
114 -ui --disable-cp246
116 read undefined len UN as explicit VR
117 handling of defined length UN elements:
119 -uc --retain-un
121 retain elements as UN (default)
122 +uc --convert-un
124 convert to real VR if known
125 handling of private max-length elements (implicit VR):
127 -sq --maxlength-dict
129 read as defined in dictionary (default)
130 +sq --maxlength-seq
132 read as sequence with undefined length
133 handling of wrong delimitation items:
135 -rd --use-delim-items
137 use delimitation items from dataset (default)
138 +rd --replace-wrong-delim
140 replace wrong sequence/item delimitation items
141 handling of illegal undefined length OB/OW elements:
143 -oi --illegal-obow-rej
145 reject dataset with illegal element (default)
146 +oi --illegal-obow-conv
148 convert undefined length OB/OW element to SQ
149 handling of VOI LUT Sequence with OW VR and explicit length:
151 -vi --illegal-voi-rej
153 reject dataset with illegal VOI LUT (default)
154 +vi --illegal-voi-conv
156 convert illegal VOI LUT to SQ
157 handling of explicit length pixel data for encaps. transfer syntaxes:
159 -pe --abort-expl-pixdata
161 abort on explicit length pixel data (default)
162 +pe --use-expl-pixdata
164 use explicit length pixel data
165 general handling of parser errors:
167 +Ep --ignore-parse-errors
169 try to recover from parse errors
170 -Ep --handle-parse-errors
172 handle parse errors and stop parsing (default)
173 other parsing options:
175 +st --stop-after-elem [t]ag: "gggg,eeee" or dictionary name
177 stop parsing after element specified by t
178 automatic data correction:
180 +dc --enable-correction
182 enable automatic data correction (default)
183 -dc --disable-correction
185 disable automatic data correction
186 bitstream format of deflated input:
188 +bd --bitstream-deflated
190 expect deflated bitstream (default)
191 +bz --bitstream-zlib
193 expect deflated zlib bitstream
194 processing options
196 specific character set:
197 # the following options require support from an underlying character
199 # encoding library (see output of --version on which one is available)
200 +U8 --convert-to-utf8
202 convert all element values that are affected
203 by Specific Character Set (0008,0005) to UTF-8
204 +L1 --convert-to-latin1
206 convert affected element values to ISO 8859-1
207 +A7 --convert-to-ascii
209 convert affected element values to 7-bit ASCII
210 +C --convert-to-charset [c]harset: string
212 convert affected element values to the character
213 set specified by the DICOM defined term c
214 -Ct --transliterate
216 try to approximate characters that cannot be
217 represented through similar looking characters
218 -Cd --discard-illegal
220 discard characters that cannot be represented
221 in destination character set
222 other processing options:
224 -ig --no-invalid-groups
226 remove elements with invalid group number
227 output options
229 output file format:
230 +Fm --write-new-meta-info
232 write file format with new meta information (default)
233 +F --write-file
235 write file format
236 -F --write-dataset
238 write data set without file meta information
239 output transfer syntax:
241 +t= --write-xfer-same
243 write with same TS as input (default)
244 +te --write-xfer-little
246 write with explicit VR little endian TS
247 +tb --write-xfer-big
249 write with explicit VR big endian TS
250 +ti --write-xfer-implicit
252 write with implicit VR little endian TS
253 +td --write-xfer-deflated
255 write with deflated explicit VR little endian TS
256 +tg --write-xfer-ge
258 write private GE implicit VR little endian
259 with big endian pixel data TS (non-standard)
260 post-1993 value representations:
262 +u --enable-new-vr
264 enable support for new VRs (UN/UT) (default)
265 -u --disable-new-vr
267 disable support for new VRs, convert to OB
268 group length encoding:
270 +g= --group-length-recalc
272 recalculate group lengths if present (default)
273 +g --group-length-create
275 always write with group length elements
276 -g --group-length-remove
278 always write without group length elements
279 length encoding in sequences and items:
281 +e --length-explicit
283 write with explicit lengths (default)
284 -e --length-undefined
286 write with undefined lengths
287 +eo --write-oversized
289 write oversized explicit length sequences
290 and items with undefined length (default)
291 -eo --abort-oversized
293 abort on oversized explicit sequences/items
294 data set trailing padding (not with --write-dataset):
296 -p= --padding-retain
298 do not change padding (default if not --write-dataset)
299 -p --padding-off
301 no padding (implicit if --write-dataset)
302 +p --padding-create [f]ile-pad [i]tem-pad: integer
304 align file on multiple of f bytes
305 and items on multiple of i bytes
306 deflate compression level (only with --write-xfer-deflated):
308 +cl --compression-level [l]evel: integer (default: 6)
310 0=uncompressed, 1=fastest, 9=best compression
311
313 The level of logging output of the various command line tools and
314 underlying libraries can be specified by the user. By default, only
315 errors and warnings are written to the standard error stream. Using
316 option --verbose also informational messages like processing details
317 are reported. Option --debug can be used to get more details on the
318 internal activity, e.g. for debugging purposes. Other logging levels
319 can be selected using option --log-level. In --quiet mode only fatal
320 errors are reported. In such very severe error events, the application
321 will usually terminate. For more details on the different logging
322 levels, see documentation of module 'oflog'.
323 In case the logging output should be written to file (optionally with
325 logfile rotation), to syslog (Unix) or the event log (Windows) option
326 --log-config can be used. This configuration file also allows for
327 directing only certain messages to a particular output stream and for
328 filtering certain messages based on the module or application where
329 they are generated. An example configuration file is provided in
330 <etcdir>/logger.cfg.
331
333 All command line tools use the following notation for parameters:
334 square brackets enclose optional values (0-1), three trailing dots
335 indicate that multiple values are allowed (1-n), a combination of both
336 means 0 to n values.
337 Command line options are distinguished from parameters by a leading '+'
339 or '-' sign, respectively. Usually, order and position of command line
340 options are arbitrary (i.e. they can appear anywhere). However, if
341 options are mutually exclusive the rightmost appearance is used. This
342 behavior conforms to the standard evaluation rules of common Unix
343 shells.
344 In addition, one or more command files can be specified using an '@'
346 sign as a prefix to the filename (e.g. @command.txt). Such a command
347 argument is replaced by the content of the corresponding text file
348 (multiple whitespaces are treated as a single separator unless they
349 appear between two quotation marks) prior to any further evaluation.
350 Please note that a command file cannot contain another command file.
351 This simple but effective approach allows one to summarize common
352 combinations of options/parameters and avoids longish and confusing
353 command lines (an example is provided in file <datadir>/dumppat.txt).
354
356 The dcmconv utility will attempt to load DICOM data dictionaries
357 specified in the DCMDICTPATH environment variable. By default, i.e. if
358 the DCMDICTPATH environment variable is not set, the file
359 <datadir>/dicom.dic will be loaded unless the dictionary is built into
360 the application (default for Windows).
361 The default behavior should be preferred and the DCMDICTPATH
363 environment variable only used when alternative data dictionaries are
364 required. The DCMDICTPATH environment variable has the same format as
365 the Unix shell PATH variable in that a colon (':') separates entries.
366 On Windows systems, a semicolon (';') is used as a separator. The data
367 dictionary code will attempt to load each file specified in the
368 DCMDICTPATH environment variable. It is an error if no data dictionary
369 can be loaded.
370
372 dcmdump(1)
373
375 Copyright (C) 1994-2022 by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
376 Germany.
377Version 3.6.7 Fri Apr 22 2022 dcmconv(1)