'\" t
.\"     Title: gdcmtar
.\"    Author: Mathieu Malaterre
.\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
.\"      Date: 04/08/2024
.\"    Manual: DICOM Manipulation.
.\"    Source: GDCM 3.0.22
.\"  Language: English
.\"
.TH "GDCMTAR" "1" "04/08/2024" "GDCM 3\&.0\&.22" "DICOM Manipulation\&."
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
gdcmtar \- Concatenate/Extract DICOM files\&.
.SH "SYNOPSIS"
.PP
.if n \{\
.RS 4
.\}
.nf
gdcmtar [options] file\-in file\-out
.fi
.if n \{\
.RE
.\}
.SH "DESCRIPTION"
.PP
The
\fBgdcmtar\fR
is a command line tool used to tar/untar multi\-frames images (including SIEMENS MOSAIC file)
.SH "PARAMETERS"
.PP
.if n \{\
.RS 4
.\}
.nf
file\-in   DICOM input filename

file\-out  DICOM output filename
.fi
.if n \{\
.RE
.\}
.SH "OPTIONS"
.SS "specific options"
.PP
.if n \{\
.RS 4
.\}
.nf
     \-\-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\&.
.fi
.if n \{\
.RE
.\}
.SS "general options"
.PP
.if n \{\
.RS 4
.\}
.nf
  \-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
.fi
.if n \{\
.RE
.\}
.SS "environment variable"
.PP
.if n \{\
.RS 4
.\}
.nf
  GDCM_ROOT_UID Root UID
.fi
.if n \{\
.RE
.\}
.SH "TYPICAL USAGE"
.SS "SIEMENS Mosaic"
.PP
This option will turn a 2D frame containing sub\-frame of a SIEMENS MOSAIC into a set of MR Image Storage (legacy)\&.
.PP
.if n \{\
.RS 4
.\}
.nf
$ gdcminfo MR\-sonata\-3D\-as\-Tile\&.dcm
.fi
.if n \{\
.RE
.\}
.PP
.if n \{\
.RS 4
.\}
.nf
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)
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
.if n \{\
.RS 4
.\}
.nf
$ gdcmtar \-\-mosaic \-i MR\-sonata\-3D\-as\-Tile\&.dcm \-o mosaic \-\-pattern %03d\&.dcm
.fi
.if n \{\
.RE
.\}
.PP
Will output:
.PP
.if n \{\
.RS 4
.\}
.nf
\-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
.fi
.if n \{\
.RE
.\}
.PP
.if n \{\
.RS 4
.\}
.nf
$ gdcminfo mosaic000\&.dcm
.fi
.if n \{\
.RE
.\}
.PP
.if n \{\
.RS 4
.\}
.nf
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)
\&.\&.\&.
.fi
.if n \{\
.RE
.\}
.PP
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
.PP
.if n \{\
.RS 4
.\}
.nf
$ gdcmtar \-\-mosaic \-\-mosaic\-private \-i MR\-sonata\-3D\-as\-Tile\&.dcm \-o mosaic \-\-pattern %03d\&.dcm
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBgdcmdump\fR(1),
\fBgdcmraw\fR(1),
\fBgdcminfo\fR(1)
.SH "AUTHOR"
.PP
\fBMathieu Malaterre\fR
.RS 4
Main developer
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2006, 2011 Mathieu Malaterre
.br