QWT API (English) 7.3.0
Qt Widget Library for Technical Applications - English API Documentation
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Static Public Member Functions | List of all members
QwtBoxStatisticsCalculator Class Reference

Helper class for computing boxplot statistics from raw data. More...

#include <qwt_box_statistics.h>

Public Types

enum  WhiskerMethod {
  Tukey , Percentile , MinMax , StandardDeviation ,
  StandardError
}
 Whisker calculation method. More...
 

Public Member Functions

 QwtBoxStatisticsCalculator ()
 Constructor with default Tukey method.
 
void setWhiskerMethod (WhiskerMethod method)
 Set whisker calculation method.
 
WhiskerMethod whiskerMethod () const
 Get whisker calculation method.
 
void setWhiskerCoefficient (double coeff)
 Set whisker coefficient (1.5 for Tukey, percentile for Percentile method)
 
double whiskerCoefficient () const
 Get whisker coefficient.
 

Static Public Member Functions

static QwtBoxSample calculate (double position, const QVector< double > &sortedData, WhiskerMethod method=Tukey, double coefficient=1.5)
 Compute QwtBoxSample from sorted data.
 
static QwtBoxSample calculateFromRaw (double position, const QVector< double > &rawData, WhiskerMethod method=Tukey, double coefficient=1.5)
 Compute QwtBoxSample from unsorted data (sorts internally)
 
static QVector< double > extractOutliers (const QwtBoxSample &sample, const QVector< double > &sortedData)
 Extract outliers given box sample and sorted data.
 
static void calculateFull (double position, const QVector< double > &rawData, QwtBoxSample &sample, QwtBoxOutlierSample &outliers, WhiskerMethod method=Tukey, double coefficient=1.5)
 Compute full statistics (sample + outliers) in one call.
 

Detailed Description

Helper class for computing boxplot statistics from raw data.

Provides static methods to calculate whisker bounds, quartiles, median, and extract outliers using various methods (Tukey, percentile, SD, SE).

Member Enumeration Documentation

◆ WhiskerMethod

Whisker calculation method.

Enumerator
Tukey 

Tukey's method: whiskers extend to 1.5×IQR from Q1/Q3 (default)

Percentile 

Percentile method: whiskers at specified percentile range.

MinMax 

Min/Max method: whiskers at actual data min/max.

StandardDeviation 

Standard deviation method: whiskers at mean ± coeff×SD.

StandardError 

Standard error method: whiskers at mean ± coeff×SE.

Constructor & Destructor Documentation

◆ QwtBoxStatisticsCalculator()

QwtBoxStatisticsCalculator::QwtBoxStatisticsCalculator ( )

Constructor with default Tukey method.

Initializes the calculator with Tukey whisker method and coefficient 1.5.

Member Function Documentation

◆ calculate()

QwtBoxSample QwtBoxStatisticsCalculator::calculate ( double  position,
const QVector< double > &  sortedData,
WhiskerMethod  method = Tukey,
double  coefficient = 1.5 
)
static

Compute QwtBoxSample from sorted data.

Compute boxplot statistics from sorted data.

Calculates whisker bounds, quartiles, median, and outlier count using the specified whisker method.

Parameters
[in]positionThe position value for the resulting sample
[in]sortedDataPre-sorted data vector
[in]methodWhisker calculation method (default: Tukey)
[in]coefficientWhisker coefficient (default: 1.5)
Returns
QwtBoxSample containing computed statistics

◆ calculateFromRaw()

QwtBoxSample QwtBoxStatisticsCalculator::calculateFromRaw ( double  position,
const QVector< double > &  rawData,
WhiskerMethod  method = Tukey,
double  coefficient = 1.5 
)
static

Compute QwtBoxSample from unsorted data (sorts internally)

Compute boxplot statistics from unsorted raw data.

Sorts the data internally and then calculates statistics.

Parameters
[in]positionThe position value for the resulting sample
[in]rawDataUnsorted raw data vector
[in]methodWhisker calculation method (default: Tukey)
[in]coefficientWhisker coefficient (default: 1.5)
Returns
QwtBoxSample containing computed statistics

◆ calculateFull()

void QwtBoxStatisticsCalculator::calculateFull ( double  position,
const QVector< double > &  rawData,
QwtBoxSample sample,
QwtBoxOutlierSample outliers,
WhiskerMethod  method = Tukey,
double  coefficient = 1.5 
)
static

Compute full statistics (sample + outliers) in one call.

Compute full boxplot statistics including outliers.

Calculates both the box sample and extracts outlier values in one call.

Parameters
[in]positionThe position value for the resulting samples
[in]rawDataUnsorted raw data vector
[out]sampleOutput parameter for computed box statistics
[out]outliersOutput parameter for extracted outlier values
[in]methodWhisker calculation method (default: Tukey)
[in]coefficientWhisker coefficient (default: 1.5)

◆ extractOutliers()

QVector< double > QwtBoxStatisticsCalculator::extractOutliers ( const QwtBoxSample sample,
const QVector< double > &  sortedData 
)
static

Extract outliers given box sample and sorted data.

Extract outlier values from sorted data based on box sample.

Identifies all values outside the whisker bounds as outliers.

Parameters
[in]sampleThe box sample containing whisker bounds
[in]sortedDataPre-sorted data vector
Returns
Vector of outlier values

◆ setWhiskerCoefficient()

void QwtBoxStatisticsCalculator::setWhiskerCoefficient ( double  coeff)

Set whisker coefficient (1.5 for Tukey, percentile for Percentile method)

Set the whisker coefficient.

Parameters
[in]coeffCoefficient value (1.5 for Tukey method, percentile value for Percentile method)

◆ setWhiskerMethod()

void QwtBoxStatisticsCalculator::setWhiskerMethod ( WhiskerMethod  method)

Set whisker calculation method.

Set the whisker calculation method.

Parameters
[in]methodThe whisker method to use (Tukey, Percentile, MinMax, StandardDeviation, StandardError)

◆ whiskerCoefficient()

double QwtBoxStatisticsCalculator::whiskerCoefficient ( ) const

Get whisker coefficient.

Get the whisker coefficient.

Returns
Current whisker coefficient

◆ whiskerMethod()

QwtBoxStatisticsCalculator::WhiskerMethod QwtBoxStatisticsCalculator::whiskerMethod ( ) const

Get whisker calculation method.

Get the whisker calculation method.

Returns
Current whisker method

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