DICOM Series to Volume Operator

Authors: Holoscan SDK Team (NVIDIA)
Supported platforms: x86_64, aarch64
Language: Python
Last modified: October 9, 2025
Latest version: 1.1.0
Minimum Holoscan SDK version: 1.0.3
Tested Holoscan SDK versions: 2.2.0, 3.2.0
Contribution metric: Level 2 - Trusted

This operator converts a DICOM series into a volumetric image for downstream analysis in medical imaging workflows.

Overview

The DICOMSeriesToVolumeOperator reads a DICOM series and constructs a volume image suitable for 3D processing and visualization in Holoscan pipelines.

Requirements

• Holoscan SDK Python package
• pydicom
• numpy

Example Usage

from holoscan.core import Fragment
from operators.medical_imaging.dicom_series_to_volume_operator import DICOMSeriesToVolumeOperator

fragment = Fragment()
vol_op = DICOMSeriesToVolumeOperator(
    fragment,
    name="series_to_volume"  # Optional operator name
)

API Reference

Python

DICOMSeriesToVolumeOperator

Inherits from: Operator

This operator converts an instance of DICOMSeries into an Image object.

Methods

Method	Description
__init__(fragment)	Create an instance for a containing application object.
setup(spec)
compute(op_input, op_output, context)	Performs computation for this operator and handles I/O.
convert_to_image(study_selected_series_list)	Extracts the pixel data from a DICOM Series and other attributes to create an Image object
generate_voxel_data(series)	Applies rescale slope and rescale intercept to the pixels.
create_volumetric_image(vox_data, metadata)	Creates an instance of 3D image.
prepare_series(series)	Computes the slice normal for each slice and then projects the first voxel of each
compute_affine_transform(s_1, s_n, n, series)	Computes the affine transform for this series. It does it in both DICOM Patient oriented
create_metadata(series)	Collects all relevant metadata from the DICOM Series and creates a dictionary.