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
Author
Mathieu Malaterre
Main developer
Copyright
Copyright © 2006, 2011 Mathieu Malaterre
Info
08/22/2024 GDCM 3.0.24 DICOM Manipulation.