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

NAME

6       dcmconv - Convert DICOM file encoding
7
8

SYNOPSIS

10       dcmconv [options] dcmfile-in dcmfile-out
11

DESCRIPTION

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

PARAMETERS

18       dcmfile-in   DICOM input filename to be converted
19
20       dcmfile-out  DICOM output filename to write to
21

OPTIONS

23   general options
24         -h   --help
25                print this help text and exit
26
27              --version
28                print version information and exit
29
30              --arguments
31                print expanded command line arguments
32
33         -q   --quiet
34                quiet mode, print no warnings and errors
35
36         -v   --verbose
37                verbose mode, print processing details
38
39         -d   --debug
40                debug mode, print debug information
41
42         -l   --log-level  [l]evel: string constant
43                (fatal, error, warn, info, debug, trace)
44                use level l for the logger
45
46         -l   --log-config  [f]ilename: string
47                use config file f for the logger
48
49   input options
50       input file format:
51
52         +f   --read-file
53                read file format or data set (default)
54
55         +fo  --read-file-only
56                read file format only
57
58         -f   --read-dataset
59                read data set without file meta information
60
61       input transfer syntax:
62
63         -t=  --read-xfer-auto
64                use TS recognition (default)
65
66         -td  --read-xfer-detect
67                ignore TS specified in the file meta header
68
69         -te  --read-xfer-little
70                read with explicit VR little endian TS
71
72         -tb  --read-xfer-big
73                read with explicit VR big endian TS
74
75         -ti  --read-xfer-implicit
76                read with implicit VR little endian TS
77
78       parsing of file meta information:
79
80         +ml  --use-meta-length
81                use file meta information group length (default)
82
83         -ml  --ignore-meta-length
84                ignore file meta information group length
85
86       parsing of odd-length attributes:
87
88         +ao  --accept-odd-length
89                accept odd length attributes (default)
90
91         +ae  --assume-even-length
92                assume real length is one byte larger
93
94       handling of explicit VR:
95
96         +ev  --use-explicit-vr
97                use explicit VR from dataset (default)
98
99         -ev  --ignore-explicit-vr
100                ignore explicit VR (prefer data dictionary)
101
102       handling of non-standard VR:
103
104         +vr  --treat-as-unknown
105                treat non-standard VR as unknown (default)
106
107         -vr  --assume-implicit
108                try to read with implicit VR little endian TS
109
110       handling of undefined length UN elements:
111
112         +ui  --enable-cp246
113                read undefined len UN as implicit VR (default)
114
115         -ui  --disable-cp246
116                read undefined len UN as explicit VR
117
118       handling of defined length UN elements:
119
120         -uc  --retain-un
121                retain elements as UN (default)
122
123         +uc  --convert-un
124                convert to real VR if known
125
126       handling of private max-length elements (implicit VR):
127
128         -sq  --maxlength-dict
129                read as defined in dictionary (default)
130
131         +sq  --maxlength-seq
132                read as sequence with undefined length
133
134       handling of wrong delimitation items:
135
136         -rd  --use-delim-items
137                use delimitation items from dataset (default)
138
139         +rd  --replace-wrong-delim
140                replace wrong sequence/item delimitation items
141
142       handling of illegal undefined length OB/OW elements:
143
144         -oi  --illegal-obow-rej
145                reject dataset with illegal element (default)
146
147         +oi  --illegal-obow-conv
148                convert undefined length OB/OW element to SQ
149
150       handling of VOI LUT Sequence with OW VR and explicit length:
151
152         -vi  --illegal-voi-rej
153                reject dataset with illegal VOI LUT (default)
154
155         +vi  --illegal-voi-conv
156                convert illegal VOI LUT to SQ
157
158       handling of explicit length pixel data for encaps. transfer syntaxes:
159
160         -pe  --abort-expl-pixdata
161                abort on explicit length pixel data (default)
162
163         +pe  --use-expl-pixdata
164                use explicit length pixel data
165
166       general handling of parser errors:
167
168         +Ep  --ignore-parse-errors
169                try to recover from parse errors
170
171         -Ep  --handle-parse-errors
172                handle parse errors and stop parsing (default)
173
174       other parsing options:
175
176         +st  --stop-after-elem  [t]ag: "gggg,eeee" or dictionary name
177                stop parsing after element specified by t
178
179       automatic data correction:
180
181         +dc  --enable-correction
182                enable automatic data correction (default)
183
184         -dc  --disable-correction
185                disable automatic data correction
186
187       bitstream format of deflated input:
188
189         +bd  --bitstream-deflated
190                expect deflated bitstream (default)
191
192         +bz  --bitstream-zlib
193                expect deflated zlib bitstream
194
195   processing options
196       specific character set:
197
198         # the following options require support from an underlying character
199         # encoding library (see output of --version on which one is available)
200
201         +U8  --convert-to-utf8
202                convert all element values that are affected
203                by Specific Character Set (0008,0005) to UTF-8
204
205         +L1  --convert-to-latin1
206                convert affected element values to ISO 8859-1
207
208         +A7  --convert-to-ascii
209                convert affected element values to 7-bit ASCII
210
211         +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
215         -Ct  --transliterate
216                try to approximate characters that cannot be
217                represented through similar looking characters
218
219         -Cd  --discard-illegal
220                discard characters that cannot be represented
221                in destination character set
222
223       other processing options:
224
225         -ig  --no-invalid-groups
226                remove elements with invalid group number
227
228   output options
229       output file format:
230
231         +Fm  --write-new-meta-info
232                write file format with new meta information (default)
233
234         +F   --write-file
235                write file format
236
237         -F   --write-dataset
238                write data set without file meta information
239
240       output transfer syntax:
241
242         +t=  --write-xfer-same
243                write with same TS as input (default)
244
245         +te  --write-xfer-little
246                write with explicit VR little endian TS
247
248         +tb  --write-xfer-big
249                write with explicit VR big endian TS
250
251         +ti  --write-xfer-implicit
252                write with implicit VR little endian TS
253
254         +td  --write-xfer-deflated
255                write with deflated explicit VR little endian TS
256
257         +tg  --write-xfer-ge
258                write private GE implicit VR little endian
259                with big endian pixel data TS (non-standard)
260
261       post-1993 value representations:
262
263         +u   --enable-new-vr
264                enable support for new VRs (UN/UT) (default)
265
266         -u   --disable-new-vr
267                disable support for new VRs, convert to OB
268
269       group length encoding:
270
271         +g=  --group-length-recalc
272                recalculate group lengths if present (default)
273
274         +g   --group-length-create
275                always write with group length elements
276
277         -g   --group-length-remove
278                always write without group length elements
279
280       length encoding in sequences and items:
281
282         +e   --length-explicit
283                write with explicit lengths (default)
284
285         -e   --length-undefined
286                write with undefined lengths
287
288         +eo  --write-oversized
289                write oversized explicit length sequences
290                and items with undefined length (default)
291
292         -eo  --abort-oversized
293                abort on oversized explicit sequences/items
294
295       data set trailing padding (not with --write-dataset):
296
297         -p=  --padding-retain
298                do not change padding (default if not --write-dataset)
299
300         -p   --padding-off
301                no padding (implicit if --write-dataset)
302
303         +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
307       deflate compression level (only with --write-xfer-deflated):
308
309         +cl  --compression-level  [l]evel: integer (default: 6)
310                0=uncompressed, 1=fastest, 9=best compression
311

LOGGING

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
324       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

COMMAND LINE

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
338       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
345       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

ENVIRONMENT

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
362       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

SEE ALSO

372       dcmdump(1)
373
375       Copyright  (C)  1994-2022  by OFFIS e.V., Escherweg 2, 26121 Oldenburg,
376       Germany.
377
378
379
380Version 3.6.7                   Fri Apr 22 2022                     dcmconv(1)
Impressum