dicom2nifti

library2.6.2pypypi✓ verified 87d ago

A Python library for converting DICOM series to NIfTI format, with support for enhanced, CT, MR, and PET images. Current version 2.6.2, released 2025. Maintained by icometrix.

data ai-ml

pip install dicom2nifti

github ↗package ↗

INSTALL

IMPORT

SIG · DICOM2NIFTI

dicom2nifti

datapythonv2.6.2

Install

8.9s avg

Import

2158ms

Disk

297MB

Pass rate

4/ 10

Env Coverage4 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v2.6.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

glibc

py 3.10

✕ build_error

✓ 9.1s

py 3.11

✕ build_error

✓ 8.7s

py 3.12

✕ build_error

✓ 8.7s

py 3.13

✕ build_error

✓ 9s

py 3.9

✕ build_error

297MB installed

● package 297MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

dicom2nifti

✓ import dicom2nifti

✗ from dicom2nifti import dicom2nifti

The module itself is the function; do not import submodule.

Convert a directory of DICOM files (single series) to NIfTI.

import dicom2nifti dicom2nifti.dicom_series_to_nifti('/input/dicom/folder', '/output.nii.gz', reorient_nifti=True)

Debug

Known issues

gotchaThe function `dicom_series_to_nifti` expects a folder containing exactly one DICOM series. If the folder contains multiple series or non-DICOM files, conversion may fail or produce incorrect output.

fix

Ensure input folder contains only one series; use `dicom_series_to_nifti` with `dir` only for single-series directories.

affects: all

deprecatedThe function `dicom_array_to_nifti` is deprecated since version 2.0 and may be removed in future releases. Use `dicom_series_to_nifti` with a directory instead.

fix

Replace with `dicom_series_to_nifti` using a temporary directory containing the DICOM files.

affects: >=2.0

breakingIn version 2.0, support for Python 2 was dropped and the API was simplified. Functions like `dicom_to_nifti` and `dicom_to_nifti_parallel` were removed.

fix

Use `dicom_series_to_nifti` for single series or `dicom_series_to_nifti_multi` for multiple series.

affects: 2.0

gotchaThe `reorient_nifti` parameter defaults to `True`. If you need to preserve original orientation, set it to `False` explicitly.

fix

Call with `reorient_nifti=False` if you do not want reorientation.

affects: all

gotchaConversion may lose private tags or metadata. The library only supports standard DICOM tags and may not preserve all attributes.

fix

Use `pydicom` directly to extract any needed private tags before conversion.

affects: all

Errors

Common errors & fixes

AttributeError: module 'dicom2nifti' has no attribute 'dicom_to_nifti'

The function was renamed or removed in version 2.0.

fix

Use `dicom2nifti.dicom_series_to_nifti()` instead.

ValueError: The input is not a valid DICOM series

The input directory contains files that are not DICOM, multiple series, or incomplete data.

fix

Ensure the folder contains exactly one DICOM series with correct filenames (e.g., from a single DICOM study).

ImportError: No module named 'pydicom'

Dependency pydicom not installed.

fix

Run `pip install pydicom` or reinstall dicom2nifti with all dependencies: `pip install dicom2nifti`.

KeyError: 'SeriesInstanceUID'

Some DICOM files are missing required tags because they are not valid DICOM or corrupted.

fix

Validate your DICOM files with `pydicom.dcmread()` to check for missing tags.

Upgrade

Version history

2.6.2latest on PyPI · released Jun 23, 2025

Audit

Dependencies

nibabelrequiredNIfTI writing

pydicomrequiredDICOM parsing

numpyrequiredarray operations

Agent activity

14 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/icometrix/dicom2nifti ↗

packagehttps://pypi.org/project/dicom2nifti/ ↗