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

Computes histogram-based statistics: Uniformity, UPP, Entropy, and Median. More...

#include <mitkHistogramStatisticsCalculator.h>

Public Types

typedef double MeasurementType
 Measurement type used for histogram bins and statistics values. More...
 
typedef itk::Statistics::Histogram< MeasurementType > HistogramType
 Histogram type used as input. More...
 

Public Member Functions

 HistogramStatisticsCalculator ()
 Default constructor. Initializes all statistics to zero. More...
 
void SetHistogram (HistogramType::Pointer histogram)
 Set the histogram from which to compute statistics. More...
 
MeasurementType GetUPP ()
 Get the Uniformity of Positive Pixels (UPP). More...
 
MeasurementType GetUniformity ()
 Get the Uniformity of the histogram distribution. More...
 
MeasurementType GetEntropy ()
 Get the Shannon entropy of the histogram distribution. More...
 
MeasurementType GetMedian ()
 Get the approximated median from the histogram. More...
 
void CalculateStatistics ()
 Compute all histogram statistics (Uniformity, UPP, Entropy, Median). More...
 

Detailed Description

Computes histogram-based statistics: Uniformity, UPP, Entropy, and Median.

This class takes an itk::Statistics::Histogram<double> as input and computes the following statistics from it:

  • Uniformity: sum of squared bin frequencies (normalized).
  • UPP (Uniformity of Positive Pixels): uniformity computed only over bins with positive measurement values.
  • Entropy: Shannon entropy of the histogram distribution.
  • Median: approximation of the median from histogram bin boundaries.

Call SetHistogram() followed by CalculateStatistics() before querying results.

See also
ImageStatisticsCalculator
ImageStatisticsContainer

Definition at line 39 of file mitkHistogramStatisticsCalculator.h.

Member Typedef Documentation

◆ HistogramType

Histogram type used as input.

Definition at line 45 of file mitkHistogramStatisticsCalculator.h.

◆ MeasurementType

Measurement type used for histogram bins and statistics values.

Definition at line 43 of file mitkHistogramStatisticsCalculator.h.

Constructor & Destructor Documentation

◆ HistogramStatisticsCalculator()

mitk::HistogramStatisticsCalculator::HistogramStatisticsCalculator ( )

Default constructor. Initializes all statistics to zero.

Member Function Documentation

◆ CalculateStatistics()

void mitk::HistogramStatisticsCalculator::CalculateStatistics ( )

Compute all histogram statistics (Uniformity, UPP, Entropy, Median).

Precondition
A histogram must have been set via SetHistogram().

◆ GetEntropy()

MeasurementType mitk::HistogramStatisticsCalculator::GetEntropy ( )

Get the Shannon entropy of the histogram distribution.

Returns
The Entropy value.
Precondition
CalculateStatistics() must have been called.

◆ GetMedian()

MeasurementType mitk::HistogramStatisticsCalculator::GetMedian ( )

Get the approximated median from the histogram.

Returns
The Median value.
Precondition
CalculateStatistics() must have been called.

◆ GetUniformity()

MeasurementType mitk::HistogramStatisticsCalculator::GetUniformity ( )

Get the Uniformity of the histogram distribution.

Returns
The Uniformity value (sum of squared normalized bin frequencies).
Precondition
CalculateStatistics() must have been called.

◆ GetUPP()

MeasurementType mitk::HistogramStatisticsCalculator::GetUPP ( )

Get the Uniformity of Positive Pixels (UPP).

Returns
The UPP value computed from the histogram.
Precondition
CalculateStatistics() must have been called.

◆ SetHistogram()

void mitk::HistogramStatisticsCalculator::SetHistogram ( HistogramType::Pointer  histogram)

Set the histogram from which to compute statistics.

Parameters
[in]histogramPointer to an itk::Statistics::Histogram<double>.
Precondition
histogram must not be nullptr.

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