1GDCMTAR(1)                    DICOM Manipulation.                   GDCMTAR(1)
2
3
4

NAME

6       gdcmtar - Concatenate/Extract DICOM files.
7

SYNOPSIS

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

DESCRIPTION

12       The gdcmtar is a command line tool used to tar/untar multi-frames
13       images (including SIEMENS MOSAIC file)
14

PARAMETERS

16           file-in   DICOM input filename
17
18           file-out  DICOM output filename
19

OPTIONS

21   specific options
22                --enhance        Enhance (default)
23             -U --unenhance      Unenhance
24             -M --mosaic         Split SIEMENS Mosaic image into multiple frames.
25                --mosaic-private When splitting SIEMENS Mosaic image into multiple frames, preserve private attributes (advanced user only).
26             -p --pattern        Specify trailing file pattern.
27                --root-uid       Root UID.
28
29   general options
30             -h   --help
31                    print this help text and exit
32
33             -v   --version
34                    print version information and exit
35
36             -V   --verbose
37                    verbose mode (warning+error).
38
39             -W   --warning
40                    warning mode, print warning information
41
42             -E   --error
43                    error mode, print error information
44
45             -D   --debug
46                    debug mode, print debug information
47
48   environment variable
49             GDCM_ROOT_UID Root UID
50

TYPICAL USAGE

52   SIEMENS Mosaic
53       This option will turn a 2D frame containing sub-frame of a SIEMENS
54       MOSAIC into a set of MR Image Storage (legacy).
55
56           $ gdcminfo MR-sonata-3D-as-Tile.dcm
57
58           MediaStorage is 1.2.840.10008.5.1.4.1.1.4 [MR Image Storage]
59           TransferSyntax is 1.2.840.10008.1.2.1 [Explicit VR Little Endian]
60           NumberOfDimensions: 2
61           Dimensions: (384,384,1)
62           ...
63
64           $ gdcmtar --mosaic -i MR-sonata-3D-as-Tile.dcm -o mosaic --pattern %03d.dcm
65
66       Will output:
67
68           -rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic000.dcm
69           -rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic001.dcm
70           -rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic002.dcm
71           -rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic003.dcm
72           -rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic004.dcm
73           -rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic005.dcm
74           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic006.dcm
75           -rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic007.dcm
76           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic008.dcm
77           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic009.dcm
78           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic010.dcm
79           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic011.dcm
80           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic012.dcm
81           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic013.dcm
82           -rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic014.dcm
83           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic015.dcm
84           -rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic016.dcm
85           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic017.dcm
86           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic018.dcm
87           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic019.dcm
88           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic020.dcm
89           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic021.dcm
90           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic022.dcm
91           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic023.dcm
92           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic024.dcm
93           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic025.dcm
94           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic026.dcm
95           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic027.dcm
96           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic028.dcm
97           -rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic029.dcm
98           -rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic030.dcm
99
100           $ gdcminfo mosaic000.dcm
101
102           MediaStorage is 1.2.840.10008.5.1.4.1.1.4 [MR Image Storage]
103           TransferSyntax is 1.2.840.10008.1.2.1 [Explicit VR Little Endian]
104           NumberOfDimensions: 2
105           Dimensions: (64,64,1)
106           ...
107
108       By default all private attributes are removed since they may not match
109       the newly generated SOP Instance. One way to preserve the private
110       attributes is to use the --mosaic-private command line option
111
112           $ gdcmtar --mosaic --mosaic-private -i MR-sonata-3D-as-Tile.dcm -o mosaic --pattern %03d.dcm
113

SEE ALSO

115       gdcmdump(1), gdcmraw(1), gdcminfo(1)
116

AUTHOR

118       Mathieu Malaterre
119           Main developer
120

COPYRIGHT

122       Copyright © 2006, 2011 Mathieu Malaterre
123
124
125
126GDCM 3.0.22                       08/07/2023                        GDCMTAR(1)