Output descriptor for DICOMFileReader. More...

#include <mitkDICOMImageBlockDescriptor.h>

Inheritance diagram for mitk::DICOMImageBlockDescriptor:

Collaboration diagram for mitk::DICOMImageBlockDescriptor:

Public Types
typedef std::map< DICOMTagPath, std::string >	AdditionalTagsMapType

typedef std::function< mitk::BaseProperty::Pointer(const DICOMCachedValueLookupTable &) >	TagLookupTableToPropertyFunctor

Public Member Functions
	DICOMImageBlockDescriptor ()

	~DICOMImageBlockDescriptor () override

	DICOMImageBlockDescriptor (const DICOMImageBlockDescriptor &other)

DICOMImageBlockDescriptor &	operator= (const DICOMImageBlockDescriptor &other)

void	SetImageFrameList (const DICOMImageFrameList &framelist)
	List of frames that constitute the mitk::Image (DICOMImageFrames) More...

const DICOMImageFrameList &	GetImageFrameList () const
	List of frames that constitute the mitk::Image (DICOMImageFrames) More...

void	SetMitkImage (Image::Pointer image)
	The 3D mitk::Image that is loaded from the DICOM files of a DICOMImageFrameList. More...

Image::Pointer	GetMitkImage () const
	the 3D mitk::Image that is loaded from the DICOM files of a DICOMImageFrameList More...

ReaderImplementationLevel	GetReaderImplementationLevel () const
	Reader's capability to appropriately load this set of frames. More...

void	SetReaderImplementationLevel (const ReaderImplementationLevel &level)
	Reader's capability to appropriately load this set of frames. More...

void	SetProperty (const std::string &key, BaseProperty *value)
	Key-value store describing aspects of the image to be loaded. More...

BaseProperty *	GetProperty (const std::string &key) const
	Key-value store describing aspects of the image to be loaded. More...

std::string	GetPropertyAsString (const std::string &) const
	Convenience function around GetProperty() More...

void	SetFlag (const std::string &key, bool value)
	Convenience function around SetProperty() More...

bool	GetFlag (const std::string &key, bool defaultValue) const
	Convenience function around GetProperty() More...

void	SetIntProperty (const std::string &key, int value)
	Convenience function around SetProperty() More...

int	GetIntProperty (const std::string &key, int defaultValue) const
	Convenience function around GetProperty() More...

BaseProperty::ConstPointer	GetConstProperty (const std::string &propertyKey, const std::string &contextName="", bool fallBackOnDefaultContext=true) const override
	Get property by its key. More...

std::vector< std::string >	GetPropertyKeys (const std::string &contextName="", bool includeDefaultContext=false) const override
	Query keys of existing properties. More...

std::vector< std::string >	GetPropertyContextNames () const override
	Query names of existing contexts. More...

PixelSpacingInterpretation	GetPixelSpacingInterpretation () const
	Describe how the mitk::Image's pixel spacing should be interpreted. More...

void	GetDesiredMITKImagePixelSpacing (ScalarType &spacingXinMM, ScalarType &spacingYinMM) const
	Describe the correct x/y pixel spacing of the mitk::Image (which some readers might need to adjust after loading) More...

void	SetTiltInformation (const GantryTiltInformation &info)
	Describe the gantry tilt of the acquisition. More...

const GantryTiltInformation	GetTiltInformation () const
	Describe the gantry tilt of the acquisition. More...

void	SetSOPClassUID (const std::string &uid)
	SOP Class UID of this set of frames. More...

std::string	GetSOPClassUID () const
	SOP Class UID of this set of frames. More...

std::string	GetSOPClassUIDAsName () const
	SOP Class as human readable name (e.g. "CT Image Storage") More...

int	GetNumberOfTimeSteps () const

int	GetNumberOfFramesPerTimeStep () const

void	SetTagCache (DICOMTagCache *privateCache)

void	SetAdditionalTagsOfInterest (const AdditionalTagsMapType &tagMap)
	Set a list of DICOMTagPaths that specifiy all DICOM-Tags that will be copied into the property of the mitk::Image. More...

void	SetTagLookupTableToPropertyFunctor (TagLookupTableToPropertyFunctor)
	Set a functor that defines how the slice-specific tag-values are stored in a Property. More...

void	Print (std::ostream &os, bool filenameDetails) const
	Print information about this image block to given stream. More...

Public Member Functions inherited from mitk::IPropertyProvider
virtual	~IPropertyProvider ()

Static Public Member Functions
static DICOMTagList	GetTagsOfInterest ()

Detailed Description

Output descriptor for DICOMFileReader.

As a result of analysis by a mitk::DICOMFileReader, this class describes the properties of a single mitk::Images that could be loaded by the file reader.

The descriptor contains the following information:

the mitk::Image itself. This will be nullptr after analysis and only be present after actual loading.
a list of frames (mostly: filenames) that went into composition of the mitk::Image.
an assessment of the reader's ability to load this set of files (ReaderImplementationLevel)
this can be used for reader selection when one reader is able to load an image with correct colors and the other is able to produce only gray values, for example
description of aspects of the image. Mostly a key-value list implemented by means of mitk::PropertyList.
for specific keys and possible values, see documentation of specific readers.

Note: an mitk::Image may both consist of multiple files (the "old" DICOM way) or a mitk::Image may be described by a single DICOM file or even only parts of a DICOM file (the newer multi-frame DICOM classes). To reflect this DICOMImageFrameList describes a list of frames from different or a single file.

Described aspects of an image are:

whether pixel spacing is meant to be in-patient or on-detector (mitk::PixelSpacingInterpretation)
details about a possible gantry tilt (intended for use by file readers, may be hidden later)

Definition at line 77 of file mitkDICOMImageBlockDescriptor.h.

Member Typedef Documentation

◆ AdditionalTagsMapType

typedef std::map<DICOMTagPath, std::string> mitk::DICOMImageBlockDescriptor::AdditionalTagsMapType

Type specifies additional tags of interest. Key is the tag path of interest. The value is an optional user defined name for the property that should be used to store the tag value(s). Empty value is default and will imply to use the found DICOMTagPath as property name.

Definition at line 170 of file mitkDICOMImageBlockDescriptor.h.

◆ TagLookupTableToPropertyFunctor

typedef std::function<mitk::BaseProperty::Pointer(const DICOMCachedValueLookupTable&) > mitk::DICOMImageBlockDescriptor::TagLookupTableToPropertyFunctor

Definition at line 184 of file mitkDICOMImageBlockDescriptor.h.

Constructor & Destructor Documentation

◆ DICOMImageBlockDescriptor() [1/2]

mitk::DICOMImageBlockDescriptor::DICOMImageBlockDescriptor ( )

Definition at line 19 of file mitkDICOMImageBlockDescriptor.cpp.

◆ ~DICOMImageBlockDescriptor()

mitk::DICOMImageBlockDescriptor::~DICOMImageBlockDescriptor ( )

override

Definition at line 28 of file mitkDICOMImageBlockDescriptor.cpp.

◆ DICOMImageBlockDescriptor() [2/2]

mitk::DICOMImageBlockDescriptor::DICOMImageBlockDescriptor ( const DICOMImageBlockDescriptor & other )

Definition at line 32 of file mitkDICOMImageBlockDescriptor.cpp.

References operator=().

Member Function Documentation

◆ GetConstProperty()

mitk::BaseProperty::ConstPointer mitk::DICOMImageBlockDescriptor::GetConstProperty	(	const std::string &	propertyKey,
		const std::string &	contextName = `""`,
		bool	fallBackOnDefaultContext = `true`
	)		const

overridevirtual

Get property by its key.

Parameters

[in]	propertyKey	Key of property.
[in]	contextName	Optional, default is empty string (default context). Search in specified context.
[in]	fallBackOnDefaultContext	Optional, default is true. Also search in default context if property was not found in given context.

Returns: Found property, nullptr otherwise.

Implements mitk::IPropertyProvider.

Definition at line 872 of file mitkDICOMImageBlockDescriptor.cpp.

◆ GetDesiredMITKImagePixelSpacing()

void mitk::DICOMImageBlockDescriptor::GetDesiredMITKImagePixelSpacing	(	ScalarType &	spacingXinMM,
		ScalarType &	spacingYinMM
	)		const

Describe the correct x/y pixel spacing of the mitk::Image (which some readers might need to adjust after loading)

Definition at line 317 of file mitkDICOMImageBlockDescriptor.cpp.

References mitk::DICOMStringToSpacing().

Referenced by GetMitkImage().

◆ GetFlag()

bool mitk::DICOMImageBlockDescriptor::GetFlag	(	const std::string &	key,
		bool	defaultValue
	)		const

Convenience function around GetProperty()

Definition at line 370 of file mitkDICOMImageBlockDescriptor.cpp.

References GetProperty().

Referenced by GetIntProperty(), and mitk::ThreeDnTDICOMSeriesReader::LoadImages().

◆ GetImageFrameList()

const mitk::DICOMImageFrameList & mitk::DICOMImageBlockDescriptor::GetImageFrameList ( ) const

List of frames that constitute the mitk::Image (DICOMImageFrames)

Definition at line 141 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by mitk::ThreeDnTDICOMSeriesReader::LoadMitkImageForImageBlockDescriptor(), mitk::DICOMITKSeriesGDCMReader::LoadMitkImageForImageBlockDescriptor(), main(), mitk::DICOMFileReaderTestHelper::TestMitkImagesAreLoaded(), and mitk::DICOMFileReaderTestHelper::TestOutputsContainInputs().

◆ GetIntProperty()

int mitk::DICOMImageBlockDescriptor::GetIntProperty	(	const std::string &	key,
		int	defaultValue
	)		const

Convenience function around GetProperty()

Definition at line 389 of file mitkDICOMImageBlockDescriptor.cpp.

References GetFlag(), GetPixelSpacingInterpretation(), GetProperty(), GetPropertyAsString(), GetSOPClassUID(), GetSOPClassUIDAsName(), GetTiltInformation(), mitk::BoolProperty::New(), mitk::StringProperty::New(), mitk::LevelWindowProperty::New(), mitk::PixelSpacingInterpretationToString(), mitk::ReaderImplementationLevelToString(), and mitk::BaseData::SetProperty().

◆ GetMitkImage()

mitk::Image::Pointer mitk::DICOMImageBlockDescriptor::GetMitkImage ( ) const

the 3D mitk::Image that is loaded from the DICOM files of a DICOMImageFrameList

Definition at line 174 of file mitkDICOMImageBlockDescriptor.cpp.

References GetDesiredMITKImagePixelSpacing(), mitk::BaseData::GetGeometry(), mitk::BaseGeometry::GetSpacing(), MITK_DEBUG, and mitk::BaseGeometry::SetSpacing().

Referenced by mitk::TestDICOMLoading::DecorateVerifyCachedImage(), mitk::TestDICOMLoading::LoadFiles(), mitkDICOMSimpleVolumeImportTest(), mitk::BaseDICOMReaderService::Read(), mitk::RTDoseReaderService::Read(), and mitk::DICOMFileReaderTestHelper::TestMitkImagesAreLoaded().

◆ GetNumberOfFramesPerTimeStep()

int mitk::DICOMImageBlockDescriptor::GetNumberOfFramesPerTimeStep ( ) const

return the number of frames that constitute one timestep.

Definition at line 584 of file mitkDICOMImageBlockDescriptor.cpp.

References GetNumberOfTimeSteps().

Referenced by mitk::ThreeDnTDICOMSeriesReader::LoadMitkImageForImageBlockDescriptor().

◆ GetNumberOfTimeSteps()

int mitk::DICOMImageBlockDescriptor::GetNumberOfTimeSteps ( ) const

Convinience method that returns the property timesteps

Definition at line 576 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by GetNumberOfFramesPerTimeStep(), and mitk::ThreeDnTDICOMSeriesReader::LoadMitkImageForImageBlockDescriptor().

◆ GetPixelSpacingInterpretation()

mitk::PixelSpacingInterpretation mitk::DICOMImageBlockDescriptor::GetPixelSpacingInterpretation ( ) const

Describe how the mitk::Image's pixel spacing should be interpreted.

Definition at line 254 of file mitkDICOMImageBlockDescriptor.cpp.

References MITK_ERROR, mitk::SpacingAtDetector, mitk::SpacingInPatient, and mitk::SpacingUnknown.

Referenced by GetIntProperty(), and Print().

◆ GetProperty()

mitk::BaseProperty * mitk::DICOMImageBlockDescriptor::GetProperty ( const std::string & key ) const

Key-value store describing aspects of the image to be loaded.

Definition at line 345 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by GetFlag(), and GetIntProperty().

◆ GetPropertyAsString()

std::string mitk::DICOMImageBlockDescriptor::GetPropertyAsString ( const std::string & key ) const

Convenience function around GetProperty()

Definition at line 351 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by GetIntProperty().

◆ GetPropertyContextNames()

std::vector< std::string > mitk::DICOMImageBlockDescriptor::GetPropertyContextNames ( ) const

overridevirtual

Query names of existing contexts.

Returns: List of context names.

Implements mitk::IPropertyProvider.

Definition at line 885 of file mitkDICOMImageBlockDescriptor.cpp.

◆ GetPropertyKeys()

std::vector< std::string > mitk::DICOMImageBlockDescriptor::GetPropertyKeys	(	const std::string &	contextName = `""`,
		bool	includeDefaultContext = `false`
	)		const

overridevirtual

Query keys of existing properties.

Parameters

[in]	contextName	Optional, default is empty string (default context). Search in specified context.
[in]	includeDefaultContext	Optional, default is false. Include default context.

Returns: List of property keys.

Implements mitk::IPropertyProvider.

Definition at line 879 of file mitkDICOMImageBlockDescriptor.cpp.

◆ GetReaderImplementationLevel()

mitk::ReaderImplementationLevel mitk::DICOMImageBlockDescriptor::GetReaderImplementationLevel ( ) const

Reader's capability to appropriately load this set of frames.

Definition at line 531 of file mitkDICOMImageBlockDescriptor.cpp.

◆ GetSOPClassUID()

std::string mitk::DICOMImageBlockDescriptor::GetSOPClassUID ( ) const

SOP Class UID of this set of frames.

Definition at line 536 of file mitkDICOMImageBlockDescriptor.cpp.

References MITK_ERROR.

Referenced by GetIntProperty(), and GetSOPClassUIDAsName().

◆ GetSOPClassUIDAsName()

std::string mitk::DICOMImageBlockDescriptor::GetSOPClassUIDAsName ( ) const

SOP Class as human readable name (e.g. "CT Image Storage")

Definition at line 551 of file mitkDICOMImageBlockDescriptor.cpp.

References GetSOPClassUID(), and MITK_ERROR.

Referenced by GetIntProperty(), and Print().

◆ GetTagsOfInterest()

mitk::DICOMTagList mitk::DICOMImageBlockDescriptor::GetTagsOfInterest ( )

static

Definition at line 84 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by mitk::DICOMITKSeriesGDCMReader::GetTagsOfInterest().

◆ GetTiltInformation()

const mitk::GantryTiltInformation mitk::DICOMImageBlockDescriptor::GetTiltInformation ( ) const

Describe the gantry tilt of the acquisition.

Definition at line 127 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by GetIntProperty(), mitk::ThreeDnTDICOMSeriesReader::LoadMitkImageForImageBlockDescriptor(), mitk::DICOMITKSeriesGDCMReader::LoadMitkImageForImageBlockDescriptor(), and Print().

◆ operator=()

mitk::DICOMImageBlockDescriptor & mitk::DICOMImageBlockDescriptor::operator= ( const DICOMImageBlockDescriptor & other )

Definition at line 54 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by DICOMImageBlockDescriptor().

◆ Print()

void mitk::DICOMImageBlockDescriptor::Print	(	std::ostream &	os,
		bool	filenameDetails
	)		const

Print information about this image block to given stream.

Definition at line 641 of file mitkDICOMImageBlockDescriptor.cpp.

References GetPixelSpacingInterpretation(), GetSOPClassUIDAsName(), GetTiltInformation(), mitk::PixelSpacingInterpretationToString(), printBool, printProperty, and printPropertyRange.

Referenced by mitk::DICOMFileReader::PrintOutputs().

◆ SetAdditionalTagsOfInterest()

void mitk::DICOMImageBlockDescriptor::SetAdditionalTagsOfInterest ( const AdditionalTagsMapType & tagMap )

Set a list of DICOMTagPaths that specifiy all DICOM-Tags that will be copied into the property of the mitk::Image.

This method can be used to specify a list of DICOM-tags that shall be available after the loading. The value in the tagMap is an optional user defined name for the property key that should be used when storing the property). Empty value is default and will imply to use the found DICOMTagPath as property key. By default the content of the DICOM tags will be stored in a StringLookupTable on the mitk::Image. This behaviour can be changed by setting a different TagLookupTableToPropertyFunctor via SetTagLookupTableToPropertyFunctor().

Definition at line 115 of file mitkDICOMImageBlockDescriptor.cpp.

◆ SetFlag()

void mitk::DICOMImageBlockDescriptor::SetFlag	(	const std::string &	key,
		bool	value
	)

Convenience function around SetProperty()

Definition at line 365 of file mitkDICOMImageBlockDescriptor.cpp.

References mitk::BoolProperty::New().

◆ SetImageFrameList()

void mitk::DICOMImageBlockDescriptor::SetImageFrameList ( const DICOMImageFrameList & framelist )

List of frames that constitute the mitk::Image (DICOMImageFrames)

Definition at line 132 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by mitk::DICOMNullFileReader::AnalyzeInputFiles(), and mitk::TestDICOMLoading::DecorateVerifyCachedImage().

◆ SetIntProperty()

void mitk::DICOMImageBlockDescriptor::SetIntProperty	(	const std::string &	key,
		int	value
	)

Convenience function around SetProperty()

Definition at line 384 of file mitkDICOMImageBlockDescriptor.cpp.

References mitk::IntProperty::New().

◆ SetMitkImage()

void mitk::DICOMImageBlockDescriptor::SetMitkImage ( Image::Pointer image )

The 3D mitk::Image that is loaded from the DICOM files of a DICOMImageFrameList.

Definition at line 146 of file mitkDICOMImageBlockDescriptor.cpp.

References MITK_ERROR.

Referenced by mitk::TestDICOMLoading::DecorateVerifyCachedImage(), mitk::ThreeDnTDICOMSeriesReader::LoadMitkImageForImageBlockDescriptor(), and mitk::DICOMITKSeriesGDCMReader::LoadMitkImageForImageBlockDescriptor().

◆ SetProperty()

void mitk::DICOMImageBlockDescriptor::SetProperty	(	const std::string &	key,
		BaseProperty *	value
	)

Key-value store describing aspects of the image to be loaded.

Definition at line 340 of file mitkDICOMImageBlockDescriptor.cpp.

◆ SetReaderImplementationLevel()

void mitk::DICOMImageBlockDescriptor::SetReaderImplementationLevel ( const ReaderImplementationLevel & level )

Reader's capability to appropriately load this set of frames.

Definition at line 526 of file mitkDICOMImageBlockDescriptor.cpp.

◆ SetSOPClassUID()

void mitk::DICOMImageBlockDescriptor::SetSOPClassUID ( const std::string & uid )

SOP Class UID of this set of frames.

◆ SetTagCache()

void mitk::DICOMImageBlockDescriptor::SetTagCache ( DICOMTagCache * privateCache )

Definition at line 595 of file mitkDICOMImageBlockDescriptor.cpp.

Referenced by mitk::DICOMITKSeriesGDCMReader::AnalyzeInputFiles(), mitk::ThreeDnTDICOMSeriesReader::Condense3DBlocks(), and mitk::TestDICOMLoading::DecorateVerifyCachedImage().

◆ SetTagLookupTableToPropertyFunctor()

void mitk::DICOMImageBlockDescriptor::SetTagLookupTableToPropertyFunctor ( TagLookupTableToPropertyFunctor functor )

Set a functor that defines how the slice-specific tag-values are stored in a Property.

This method sets a functor that is given a StringLookupTable that contains the values of one DICOM tag mapped to the slice index. The functor is supposed to store these values in an mitk Property.

By default, the StringLookupTable is stored in a StringLookupTableProperty except if all values are identical. In this case, the unique value is stored only once in a StringProperty.

Definition at line 864 of file mitkDICOMImageBlockDescriptor.cpp.

◆ SetTiltInformation()

void mitk::DICOMImageBlockDescriptor::SetTiltInformation ( const GantryTiltInformation & info )

Describe the gantry tilt of the acquisition.

Definition at line 122 of file mitkDICOMImageBlockDescriptor.cpp.

References info().

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

Public Types

Public Member Functions

Static Public Member Functions

Detailed Description

Member Typedef Documentation

◆ AdditionalTagsMapType

◆ TagLookupTableToPropertyFunctor

Constructor & Destructor Documentation

◆ DICOMImageBlockDescriptor() [1/2]

◆ ~DICOMImageBlockDescriptor()

◆ DICOMImageBlockDescriptor() [2/2]

Member Function Documentation

◆ GetConstProperty()

◆ GetDesiredMITKImagePixelSpacing()

◆ GetFlag()

◆ GetImageFrameList()

◆ GetIntProperty()

◆ GetMitkImage()

◆ GetNumberOfFramesPerTimeStep()

◆ GetNumberOfTimeSteps()

◆ GetPixelSpacingInterpretation()

◆ GetProperty()

◆ GetPropertyAsString()

◆ GetPropertyContextNames()

◆ GetPropertyKeys()

◆ GetReaderImplementationLevel()

◆ GetSOPClassUID()

◆ GetSOPClassUIDAsName()

◆ GetTagsOfInterest()

◆ GetTiltInformation()

◆ operator=()

◆ Print()

◆ SetAdditionalTagsOfInterest()

◆ SetFlag()

◆ SetImageFrameList()

◆ SetIntProperty()

◆ SetMitkImage()

◆ SetProperty()

◆ SetReaderImplementationLevel()

◆ SetSOPClassUID()

◆ SetTagCache()

◆ SetTagLookupTableToPropertyFunctor()

◆ SetTiltInformation()