gdcmtar - Man Page

Concatenate/Extract DICOM files​.

Synopsis

gdcmtar [options] file-in file-out

Description

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

Parameters

file-in   DICOM input filename

file-out  DICOM output filename

Options

specific options

     --enhance        Enhance (default)
  -U --unenhance      Unenhance
  -M --mosaic         Split SIEMENS Mosaic image into multiple frames​.
     --mosaic-private When splitting SIEMENS Mosaic image into multiple frames, preserve private attributes (advanced user only)​.
  -p --pattern        Specify trailing file pattern​.
     --root-uid       Root UID​.

general options

  -h   --help
         print this help text and exit

  -v   --version
         print version information and exit

  -V   --verbose
         verbose mode (warning+error)​.

  -W   --warning
         warning mode, print warning information

  -E   --error
         error mode, print error information

  -D   --debug
         debug mode, print debug information

environment variable

  GDCM_ROOT_UID Root UID

Typical Usage

SIEMENS Mosaic

This option will turn a 2D frame containing sub-frame of a SIEMENS MOSAIC into a set of MR Image Storage (legacy)​.

$ gdcminfo MR-sonata-3D-as-Tile​.dcm
MediaStorage is 1​.2​.840​.10008​.5​.1​.4​.1​.1​.4 [MR Image Storage]
TransferSyntax is 1​.2​.840​.10008​.1​.2​.1 [Explicit VR Little Endian]
NumberOfDimensions: 2
Dimensions: (384,384,1)
​.​.​.
$ gdcmtar --mosaic -i MR-sonata-3D-as-Tile​.dcm -o mosaic --pattern %03d​.dcm

Will output:

-rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic000​.dcm
-rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic001​.dcm
-rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic002​.dcm
-rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic003​.dcm
-rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic004​.dcm
-rw-r--r--   1 mathieu mathieu 72886 2009-08-10 11:14 mosaic005​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic006​.dcm
-rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic007​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic008​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic009​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic010​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic011​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic012​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic013​.dcm
-rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic014​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic015​.dcm
-rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic016​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic017​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic018​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic019​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic020​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic021​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic022​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic023​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic024​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic025​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic026​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic027​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic028​.dcm
-rw-r--r--   1 mathieu mathieu 72884 2009-08-10 11:14 mosaic029​.dcm
-rw-r--r--   1 mathieu mathieu 72882 2009-08-10 11:14 mosaic030​.dcm
$ gdcminfo mosaic000​.dcm
MediaStorage is 1​.2​.840​.10008​.5​.1​.4​.1​.1​.4 [MR Image Storage]
TransferSyntax is 1​.2​.840​.10008​.1​.2​.1 [Explicit VR Little Endian]
NumberOfDimensions: 2
Dimensions: (64,64,1)
​.​.​.

By default all private attributes are removed since they may not match the newly generated SOP Instance​. One way to preserve the private attributes is to use the --mosaic-private command line option

$ gdcmtar --mosaic --mosaic-private -i MR-sonata-3D-as-Tile​.dcm -o mosaic --pattern %03d​.dcm

See Also

gdcmdump(1), gdcmraw(1), gdcminfo(1)

Author

Mathieu Malaterre

Main developer

Info

08/07/2026 GDCM 3.0.24 DICOM Manipulation.