NAME

       dinifti - converts DICOM files into the NIfTI format

SYNOPSIS

       dinifti [options] <DICOM input> <NIfTI output>

DESCRIPTION

       dinifti  converts  a  single or several files at once into the NIfTI data format.  The DICOM input can be
       specified as a single filename, a list of file or a directory. In case of a directory all files  in  this
       directory will be converted.

       Images  belonging  to the same recording series will be appropriately merged into a single 3d or 4d NIfTI
       file.  To achieve this dinifti gathers the number of time points and number of slices per volume from the
       DICOM  header.  When this is impossible, dinifti will issue a warning (i.e. when it can find only 1 slice
       per volume and 1 time point). The user has the option of running the program  using  the  -s  option  and
       specifying the number of slices per volume.

       A  number  of  items  are retrieved from the Siemens Shadow set. Following is a list of items and default
       value if this is not Siemens.

              Number of groups: 1

              Number of channels: 1

              Sagital, Coronal and Transverse position: From DICOM (0020,0032)

OPTIONS

       -g     NIfTI files will be compressed.

       -f [a2|n2|n1]
              Set the output file format.  If set to a2 ANALYZE 7.5 file  pairs  (hdr/img)  will  be  generates.
              Setting  n2 will cause dinifti to generate NIfTI image file pairs.  The default output format (n1)
              are single NIfTI files (header and image data combined in one file).

       -d     If set dinifti appends the series description from the DICOM header to the output file name(s).

              If two image series share a  common  description  dinifti  will  append  as  many   characters  as
              necessary  to  the  second  series description to create a unique filename. In this case a warning
              message is displayed that shows the old and the modified filename.

       --name="<format>"
              Format output file name(s) according to <format> string, which has to be enclosed in quotes (")

              The format is interpreted in the usual printf-like way. Ordinary characters are directly copied, a
              percent  sign  is represented by %%, otherwise % indicates a conversion. The special character "/"
              is translated to "~" to avoid confusion with the directory separator.

              If --name is present, -d flag will be ignored.

              %I Subject ID

              %N Subject name

              %S Relative series number

              %D Series description

              %Y Series date (YYYYMMDD)

              %T Series time (HHMM)

              %A Accession number

              %C Image comments

              Example: --name="%Y:%T- %A - %I -%D(%S)"

       -s #   This option can be used to specify the number of  slices  in  the  volume,  if  dinifti  fails  to
              autodetect the correct value.

       -v, --verbose
              Enables  verbose  status  messages.  If  any warning message occurs, this option can be helpful to
              determine which imageseries caused it.

       -n, --noact
              If set, dinifti performs all processing steps, but does not write NIfTI files at the end. This can
              be useful to quickly inspect the content of a DICOM directory (if ran together with --verbose).

       -h, --help
              Print this help page and exit.

       -V, --version
              Print the version number and exit.

AUTHOR

       dinifti is written by Valerio Luccio (valerio.luccio@nyu.edu).

SEE ALSO

       Homepage: http://cbi.nyu.edu/software/dinifti.php

MAILING LIST

       List page: http://cbi.nyu.edu/mailman/listinfo/dinifti List email: dinifti@cbi.nyu.edu

LICENSE

       The software is released under the standard BSD license: http://opensource.org/licenses/bsd-license.php