Utils for gathering, aggregation and handling metadata from DICOM files.

Installation

From pip

pip install dicom-csv

or from GitHub

git clone https://github.com/neuro-ml/dicom-csv
cd dicom-csv
pip install -e .

Example `join_tree`

>>> from dicom_csv import join_tree
>>> folder = '/path/to/folder/'
>>> meta = join_tree(folder, verbose=2)
>>> meta.head(3)

AccessionNumber	AcquisitionDate	...	WindowCenter	WindowWidth
000002621237	20200922	...	-500.0	1500.0
000002621237	20200922	...	-40.0	400.0
000002621237	20200922	...	-500.0	1500.0
3 rows x 155 columns

Example load 3D image

from a series of dicom files (each containing 2D image)

from dicom_csv import join_tree, order_series, stack_images
from pydicom import dcmread
from pathlib import Path

# 1. Collect metadata from all dicom files
folder = Path('/path/to/folder/')
meta = join_tree(folder, verbose=2)

# 2. Select series to load
uid = '...' # unique identifier of a series you want to load,
            # you could list them by `meta.SeriesInstanceUID.unique()`
series = meta.query("SeriesInstanceUID==@uid")

# 3. Read files & combine them into a single volume
images2d = [dcmread(folder / row[1].PathToFolder / row[1].FileName) for row in series.iterrows()] 
image3d = stack_images(order_series(images2d))

Documentation

You can find the documentation here.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

dicom_csv-0.5.1.tar.gz (20.4 kB view details)

Uploaded Apr 14, 2026 Source

File details

Details for the file dicom_csv-0.5.1.tar.gz.

File metadata

Download URL: dicom_csv-0.5.1.tar.gz
Upload date: Apr 14, 2026
Size: 20.4 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/6.2.0 CPython/3.9.25

File hashes

Hashes for dicom_csv-0.5.1.tar.gz
Algorithm	Hash digest
SHA256	`e48236081652eab0eeccde71e9db108872f6e1669c17ff52a02f1fc5e1dddb61`
MD5	`9c63e871a75984f1df096fbeec7c4924`
BLAKE2b-256	`26c1f0f6e8a95f8cbacf3c4a44d06b041924ff9116ca61d345d3ccd19d000c73`