Medical Imaging Interaction Toolkit  2026.06.00
Medical Imaging Interaction Toolkit
mitk::ImageStatisticsContainer::ImageStatisticsObject Class Reference

Container class for storing the computed image statistics. More...

#include <mitkImageStatisticsContainer.h>

Public Types

using RealType = double
 
using IndexType = vnl_vector< int >
 
using VoxelCountType = unsigned long
 
using StatisticsVariantType = boost::variant< RealType, VoxelCountType, IndexType >
 
using StatisticNameVector = std::vector< std::string >
 

Public Member Functions

 ImageStatisticsObject ()
 
void AddStatistic (const std::string_view key, StatisticsVariantType value)
 Adds a statistic to the statistics object. More...
 
const StatisticNameVector & GetCustomStatisticNames () const
 Returns the names of all custom statistics (defined at runtime and no default names). More...
 
StatisticNameVector GetAllStatisticNames () const
 Returns the names of all statistics (default and custom defined) Additional custom keys are added at the end in a sorted order. More...
 
StatisticNameVector GetExistingStatisticNames () const
 Returns the names of statistics that actually have stored values. More...
 
bool HasStatistic (const std::string_view name) const
 Check whether a statistic with the given name exists. More...
 
template<typename TType >
TType GetValueConverted (const std::string_view name) const
 Converts the requested value to the defined type. More...
 
StatisticsVariantType GetValueNonConverted (const std::string_view name) const
 Returns the requested value. More...
 
void Reset ()
 Clear all stored statistics and custom names. More...
 

Static Public Member Functions

static const StatisticNameVector & GetDefaultStatisticNames ()
 Returns the names of the default statistics. More...
 

Public Attributes

HistogramType::ConstPointer m_Histogram
 The histogram of pixel values for this statistics object. Can be nullptr. More...
 

Detailed Description

Container class for storing the computed image statistics.

The statistics are stored in a map <name,value> with value as boost::variant<RealType, VoxelCountType, IndexType >. The type used to create the boost::variant is important as only this type can be recovered later on.

Definition at line 61 of file mitkImageStatisticsContainer.h.

Member Typedef Documentation

◆ IndexType

◆ RealType

◆ StatisticNameVector

◆ StatisticsVariantType

◆ VoxelCountType

Constructor & Destructor Documentation

◆ ImageStatisticsObject()

mitk::ImageStatisticsContainer::ImageStatisticsObject::ImageStatisticsObject ( )

Member Function Documentation

◆ AddStatistic()

void mitk::ImageStatisticsContainer::ImageStatisticsObject::AddStatistic ( const std::string_view  key,
StatisticsVariantType  value 
)

Adds a statistic to the statistics object.

if already a statistic with that name is included, it is overwritten

◆ GetAllStatisticNames()

StatisticNameVector mitk::ImageStatisticsContainer::ImageStatisticsObject::GetAllStatisticNames ( ) const

Returns the names of all statistics (default and custom defined) Additional custom keys are added at the end in a sorted order.

◆ GetCustomStatisticNames()

const StatisticNameVector& mitk::ImageStatisticsContainer::ImageStatisticsObject::GetCustomStatisticNames ( ) const

Returns the names of all custom statistics (defined at runtime and no default names).

◆ GetDefaultStatisticNames()

static const StatisticNameVector& mitk::ImageStatisticsContainer::ImageStatisticsObject::GetDefaultStatisticNames ( )
static

Returns the names of the default statistics.

The order is derived from the image statistics plugin.

◆ GetExistingStatisticNames()

StatisticNameVector mitk::ImageStatisticsContainer::ImageStatisticsObject::GetExistingStatisticNames ( ) const

Returns the names of statistics that actually have stored values.

Returns
A vector of statistic names for which values exist.

◆ GetValueConverted()

template<typename TType >
TType mitk::ImageStatisticsContainer::ImageStatisticsObject::GetValueConverted ( const std::string_view  name) const
inline

Converts the requested value to the defined type.

Parameters
namedefined string on creation (AddStatistic)
Exceptions
ifno statistics with key name was found.

Definition at line 115 of file mitkImageStatisticsContainer.h.

◆ GetValueNonConverted()

StatisticsVariantType mitk::ImageStatisticsContainer::ImageStatisticsObject::GetValueNonConverted ( const std::string_view  name) const

Returns the requested value.

Exceptions
ifno statistics with key name was found.

◆ HasStatistic()

bool mitk::ImageStatisticsContainer::ImageStatisticsObject::HasStatistic ( const std::string_view  name) const

Check whether a statistic with the given name exists.

Parameters
[in]nameThe name of the statistic to query.
Returns
True if a statistic with the given name has been added.

◆ Reset()

void mitk::ImageStatisticsContainer::ImageStatisticsObject::Reset ( )

Clear all stored statistics and custom names.

Member Data Documentation

◆ m_Histogram

HistogramType::ConstPointer mitk::ImageStatisticsContainer::ImageStatisticsObject::m_Histogram

The histogram of pixel values for this statistics object. Can be nullptr.

Definition at line 131 of file mitkImageStatisticsContainer.h.


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