---
name: "dinifti"
section: "1"
platform: "linux"
package: "dicomnifti"
version: "2.33.1-5"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/dinifti"
---

# dinifti(1)

converts DICOM files into the NIfTI format

## 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