1gdcm2vtk(1)                          GDCM                          gdcm2vtk(1)
2
3
4

NAME

6       gdcm2vtk - Convert a file supported by VTK into DICOM.
7

SYNOPSIS

9       gdcm2vtk [options] file-in file-out
10

DESCRIPTION

12       The gdcm2vtk takes as input any file supported by VTK (including DICOM
13       file) and will generate as output a DICOM file.
14

PARAMETERS

16       file-in   input filename (DICOM or VTK supported)
17
18       file-out  DICOM output filename
19

OPTIONS

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

DESCRIPTION

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

CONVERT DICOM

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

SEE ALSO

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)
Impressum