Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::ITKDICOMSeriesReaderHelper Class Reference

Helper class that uses ITK's ImageSeriesReader to load DICOM images. More...

#include <mitkITKDICOMSeriesReaderHelper.h>

Collaboration diagram for mitk::ITKDICOMSeriesReaderHelper:

Public Types

typedef std::vector< std::string > StringContainer
 A list of file path strings for a single 3D volume. More...
 
typedef std::list< StringContainer > StringContainerList
 A list of StringContainer instances, one per time step (for 3D+t loading). More...
 

Public Member Functions

Image::Pointer Load (const StringContainer &filenames, bool correctTilt, const GantryTiltInformation &tiltInfo)
 Load a single 3D DICOM image from the given files. More...
 
Image::Pointer Load3DnT (const StringContainerList &filenamesLists, bool correctTilt, const GantryTiltInformation &tiltInfo)
 Load a 3D+t DICOM image from multiple time step file lists. More...
 

Static Public Member Functions

static bool CanHandleFile (const std::string &filename)
 Check if the given file can be handled by this reader (i.e. is readable by GDCM). More...
 

Static Public Attributes

static const DICOMTag AcquisitionDateTag
 DICOM tag (0008,0022) Acquisition Date. More...
 
static const DICOMTag AcquisitionTimeTag
 DICOM tag (0008,0032) Acquisition Time. More...
 
static const DICOMTag TriggerTimeTag
 DICOM tag (0018,1060) Trigger Time. More...
 

Detailed Description

Helper class that uses ITK's ImageSeriesReader to load DICOM images.

This class encapsulates the actual loading of DICOM images using itk::ImageSeriesReader and itk::GDCMImageIO. It handles pixel type dispatching, gantry tilt correction via shearing, and time geometry generation for 3D+t datasets.

See also
DICOMITKSeriesGDCMReader, GantryTiltInformation

Definition at line 38 of file mitkITKDICOMSeriesReaderHelper.h.

Member Typedef Documentation

◆ StringContainer

typedef std::vector<std::string> mitk::ITKDICOMSeriesReaderHelper::StringContainer

A list of file path strings for a single 3D volume.

Definition at line 47 of file mitkITKDICOMSeriesReaderHelper.h.

◆ StringContainerList

A list of StringContainer instances, one per time step (for 3D+t loading).

Definition at line 49 of file mitkITKDICOMSeriesReaderHelper.h.

Member Function Documentation

◆ CanHandleFile()

static bool mitk::ITKDICOMSeriesReaderHelper::CanHandleFile ( const std::string &  filename)
static

Check if the given file can be handled by this reader (i.e. is readable by GDCM).

Parameters
[in]filenameThe file path to check.
Returns
true if the file can be read as a DICOM image.

◆ Load()

Image::Pointer mitk::ITKDICOMSeriesReaderHelper::Load ( const StringContainer &  filenames,
bool  correctTilt,
const GantryTiltInformation &  tiltInfo 
)

Load a single 3D DICOM image from the given files.

Parameters
[in]filenamesThe list of DICOM file paths constituting one 3D volume.
[in]correctTiltWhether to apply gantry tilt correction via shearing.
[in]tiltInfoThe gantry tilt information describing the tilt geometry.
Returns
A smart pointer to the loaded mitk::Image.

◆ Load3DnT()

Image::Pointer mitk::ITKDICOMSeriesReaderHelper::Load3DnT ( const StringContainerList &  filenamesLists,
bool  correctTilt,
const GantryTiltInformation &  tiltInfo 
)

Load a 3D+t DICOM image from multiple time step file lists.

Parameters
[in]filenamesListsA list of file lists, one per time step.
[in]correctTiltWhether to apply gantry tilt correction via shearing.
[in]tiltInfoThe gantry tilt information describing the tilt geometry.
Returns
A smart pointer to the loaded mitk::Image with time geometry.

Member Data Documentation

◆ AcquisitionDateTag

const DICOMTag mitk::ITKDICOMSeriesReaderHelper::AcquisitionDateTag
static

DICOM tag (0008,0022) Acquisition Date.

Definition at line 42 of file mitkITKDICOMSeriesReaderHelper.h.

◆ AcquisitionTimeTag

const DICOMTag mitk::ITKDICOMSeriesReaderHelper::AcquisitionTimeTag
static

DICOM tag (0008,0032) Acquisition Time.

Definition at line 43 of file mitkITKDICOMSeriesReaderHelper.h.

◆ TriggerTimeTag

const DICOMTag mitk::ITKDICOMSeriesReaderHelper::TriggerTimeTag
static

DICOM tag (0018,1060) Trigger Time.

Definition at line 44 of file mitkITKDICOMSeriesReaderHelper.h.


The documentation for this class was generated from the following file: