Scroll to navigation

DINIFTI(1) User Commands DINIFTI(1)

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
August 2006 Valerio Luccio