1gdcm2vtk(1) GDCM gdcm2vtk(1)
2
3
4
6 gdcm2vtk - Convert a file supported by VTK into DICOM.
7
9 gdcm2vtk [options] file-in file-out
10
12 The gdcm2vtk takes as input any file supported by VTK (including DICOM
13 file) and will generate as output a DICOM file.
14
16 file-in input filename (DICOM or VTK supported)
17
18 file-out DICOM output filename
19
21 OPTIONS
22 --force-rescale force rescale.
23 --force-spacing force spacing.
24 --palette-color when supported generate a PALETTE COLOR file.
25 --argb when supported generate a ARGB file.
26 --compress when supported generate a compressed file.
27 --use-vtkdicom Use vtkDICOMImageReader (instead of GDCM).
28 --modality set Modality.
29 -T --study-uid Study UID.
30 -S --series-uid Series UID.
31 --root-uid Root UID.
32
33 compression options
34 -J --jpeg Compress image in jpeg.
35 -K --j2k Compress image in j2k.
36 -L --jpegls Compress image in jpeg-ls.
37 -R --rle Compress image in rle (lossless only).
38
39 general options
40 -h --help
41 print this help text and exit
42
43 -v --version
44 print version information and exit
45
46 -V --verbose
47 verbose mode (warning+error).
48
49 -W --warning
50 warning mode, print warning information
51
52 -E --error
53 error mode, print error information
54
55 -D --debug
56 debug mode, print debug information
57
58 environment variable
59 GDCM_ROOT_UID Root UID
60
62 Convert a file supported by VTK into DICOM.
63
64 Typical usage is:
65
66 $ gdcm2vtk inputfile output.dcm
67
68 It uses the internal factory mechanism of VTK to recognize a file
69 (CanRead function). See VTK supported file here:
70
71 What image file formats can VTK read and write?
72 http://www.vtk.org/Wiki/VTK_FAQ#What_image_file_formats_can_VTK_read_and_write.3F
73
74 If your input file has 4 components, the 4th comp (alpha) will be
75 removed from the output file as DICOM does not support alpha component
76 anymore (see --argb option).
77
78 Special care was taken for the following file format:
79
80 1. DICOM: Direction Cosines and vtkMedicalImageInformation are passed to the output
81 2. BMP: The file can be saved with a Lookup Table (see --palette-color)
82 3. GE Signa: vtkMedicalImageProperties is passed to the output
83 4. MINC: Direction Cosines is passed to the output
84 5. TIFF: vtkTIFFReader is currently in bad shape in VTK (different behavior in VTK 5.2 and CVS). Only use it, if you know what you are doing.
85
86 CONVERT MetaImage (mhd, mha)
87 $ gdcm2vtk inputfile output.mha
88
89 This command will convert the input DICOM file: inputfile into a
90 MetaImage .mha file. Same goes for .mhd file.
91
92 CONVERT MHA/MHD
93 $ gdcm2vtk inputfile output.mha
94
95 or
96
97 $ gdcm2vtk inputfile output.mhd
98
99
100 This command will convert the input DICOM file: inputfile into a
101 MetaImageData .mha/.mhd file.
102
103 CONVERT VTI
104 $ gdcm2vtk inputfile output.vti
105
106 This command will convert the input DICOM file: inputfile into a XML
107 VTK ImageData .vti file.
108
109 CONVERT VTK
110 $ gdcm2vtk inputfile output.vtk
111
112 This command will convert the input DICOM file: inputfile into an old
113 VTK Structured PointSets .vtk file.
114
116 $ gdcm2vtk input.dcm output.dcm
117
118 vtkGDCMImageReader will be used to read in a DICOM file, not the
119 default vtkDICOMImageReader.
120
121 IMPORTANT NOTE: The internal VTK structured will be filled from the
122 input DICOM, and then pass to the output DICOM writer. Some information
123 might be lost during the conversion DICOM to VTK to DICOM. This option
124 is mostly used to test the vtkGDCMImageReader/vtkGDCMImageWriter
125 combination.
126
127 IMPORTANT NOTE: When converting from a lossy format such as JPEG, the
128 information of lossiness is important. The output DICOM will contains
129 the required Lossy Image Compression attribute that indicates that
130 image was lossy-compressed somewhere along the pipeline. See also
131 gdcmimg (better handling of JPEG in general).
132
133 IMPORTANT NOTE: When using --use-vtkdicom the output DICOM file will
134 always be written as MR Image Storage as this information is not
135 available from the reader itself. This allow setting the Image
136 Orientation (Patient) properly.
137
139 gdcmdump(1), gdcmviewer(1), gdcmimg(1)
140
142 Copyright (c) 2006-2010 Mathieu Malaterre
143
144
145
146Version 2.0.16 Tue Jul 26 2011 gdcm2vtk(1)