Visual Servoing Platform version 3.7.0
Loading...
Searching...
No Matches
vpStatisticalTestShewhart Class Reference
core: Core module » Tools » Statistical Process Control

#include <vpStatisticalTestShewhart.h>

Inheritance diagram for vpStatisticalTestShewhart:

Public Types

enum  vpWecoRulesAlarm {
  THREE_SIGMA_WECO = 0 , TWO_SIGMA_WECO = 1 , ONE_SIGMA_WECO = 2 , SAME_SIDE_WECO = 3 ,
  NONE_WECO = 4 , COUNT_WECO = 5
}
typedef enum vpStatisticalTestShewhart::vpWecoRulesAlarm vpWecoRulesAlarm
enum  vpMeanDriftType {
  MEAN_DRIFT_NONE = 0 , MEAN_DRIFT_DOWNWARD = 1 , MEAN_DRIFT_UPWARD = 2 , MEAN_DRIFT_BOTH = 3 ,
  MEAN_DRIFT_COUNT = 4 , MEAN_DRIFT_UNKNOWN = MEAN_DRIFT_COUNT
}
typedef enum vpStatisticalTestAbstract::vpMeanDriftType vpMeanDriftType

Public Member Functions

 vpStatisticalTestShewhart (const bool &activateWECOrules=true, const std::vector< bool > &activatedRules=CONST_ALL_WECO_ACTIVATED, const unsigned int &nbSamplesForStats=30)
 vpStatisticalTestShewhart (const bool &activateWECOrules, const std::vector< bool > &activatedRules, const float &mean, const float &stdev)
vpWecoRulesAlarm getAlarm () const
virtual float getSignal () const override
std::vector< float > getSignals () const
void init (const bool &activateWECOrules, const std::vector< bool > &activatedRules=CONST_ALL_WECO_ACTIVATED, const unsigned int &nbSamplesForStats=30)
void init (const bool &activateWECOrules, const std::vector< bool > &activatedRules, const float &mean, const float &stdev)
void init (const float &h=3.f, const unsigned int &nbSamplesForStats=30)
void init (const float &h, const float &mean, const float &stdev)
void init ()
void getLimits (float &limitDown, float &limitUp) const
float getMean () const
float getStdev () const
void setMinStdev (const float &stdevmin)
void setNbSamplesForStat (const unsigned int &nbSamples)
vpMeanDriftType testDownUpwardMeanDrift (const float &signal)
vpMeanDriftType testDownwardMeanDrift (const float &signal)
vpMeanDriftType testUpwardMeanDrift (const float &signal)

Static Public Member Functions

static std::string vpWecoRulesAlarmToString (const vpWecoRulesAlarm &alarm)
static std::string vpMeanDriftTypeToString (const vpMeanDriftType &type)
static vpMeanDriftType vpMeanDriftTypeFromString (const std::string &name)
static std::string getAvailableMeanDriftType (const std::string &prefix="<", const std::string &sep=" , ", const std::string &suffix=">")
static void print (const vpMeanDriftType &type)

Static Public Attributes

static VP_ATTRIBUTE_NO_DESTROY const std::vector< bool > CONST_ALL_WECO_ACTIVATED = std::vector<bool>(COUNT_WECO -1, true)
static const unsigned int NB_DATA_SIGNAL = 8

Protected Member Functions

virtual void computeLimits () VP_OVERRIDE
virtual vpMeanDriftType detectDownwardMeanDrift () VP_OVERRIDE
virtual vpMeanDriftType detectUpwardMeanDrift () VP_OVERRIDE
virtual bool updateStatistics (const float &signal) VP_OVERRIDE
virtual void updateTestSignals (const float &signal) VP_OVERRIDE

Protected Attributes

unsigned int m_nbDataInBuffer
float m_signal_vec [NB_DATA_SIGNAL]
bool m_activateWECOrules
std::vector< bool > m_activatedWECOrules
unsigned int m_idCurrentData
vpWecoRulesAlarm m_alarm
float m_oneSigmaNegLim
float m_oneSigmaPosLim
float m_twoSigmaNegLim
float m_twoSigmaPosLim
float m_h
float m_signal
bool m_areStatisticsComputed
float m_count
float m_limitDown
float m_limitUp
float m_mean
unsigned int m_nbSamplesForStatistics
float * m_s
float m_stdev
float m_stdevmin
float m_sumForMean

Detailed Description

Class that permits a Shewhart's test.

Be $ s(t) $ the signal to monitor, $ \mu $ and $ \sigma $ the mean and standard deviation of this signal when it is "in control".

A downward alarm is raised if: $ s(t) >= \mu - 3 \sigma $

An upward alarm is raised if: $ s(t) >= \mu + 3 \sigma $

Additionally, we can activate the WECO's rules that have been proposed by the Western Electric Company to add additional verifications:

  • An alarm is raised if two out of three consecutive points fall beyond the $2\sigma$-limit, on the same side of the mean $ \mu $
  • An alarm is raised if four out of five consecutive points fall beyond the $1\sigma$-limit, on the same side of the mean $ \mu $
  • An alarm is raised if eight consecutive points fall on the same side of the mean $ \mu $.

The user can decide to use or not the WECO's rules. Additionally, the user can choose which WECO's rule(s) to activate.

To detect only downward drifts of the input signal $ s(t) $ use testDownwardMeanDrift().To detect only upward drifts in $ s(t) $ use testUpwardMeanDrift(). To detect both, downward and upward drifts use testDownUpwardMeanDrift().

Tutorials & Examples

Tutorials
If you are interested in using Statistical Process Control methods, you may have a look at:

Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 80 of file vpStatisticalTestShewhart.h.

Member Typedef Documentation

◆ vpMeanDriftType

typedef enum vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestAbstract::vpMeanDriftType
inherited

Enum that indicates if a drift of the mean occurred.

◆ vpWecoRulesAlarm

typedef enum vpStatisticalTestShewhart::vpWecoRulesAlarm vpStatisticalTestShewhart::vpWecoRulesAlarm

Member Enumeration Documentation

◆ vpMeanDriftType

enum vpStatisticalTestAbstract::vpMeanDriftType
inherited

Enum that indicates if a drift of the mean occurred.

Enumerator
MEAN_DRIFT_NONE 

No mean drift occurred

MEAN_DRIFT_DOWNWARD 

A downward drift of the mean occurred.

MEAN_DRIFT_UPWARD 

An upward drift of the mean occurred.

MEAN_DRIFT_BOTH 

Both an aupward and a downward drifts occurred.

MEAN_DRIFT_COUNT 
MEAN_DRIFT_UNKNOWN 
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 69 of file vpStatisticalTestAbstract.h.

◆ vpWecoRulesAlarm

enum vpStatisticalTestShewhart::vpWecoRulesAlarm
Enumerator
THREE_SIGMA_WECO 

When a $ 3\sigma $ alarm was raised.

TWO_SIGMA_WECO 

When a $ 2\sigma $ alarm was raised.

ONE_SIGMA_WECO 

When a $ 1\sigma $ alarm was raised

SAME_SIDE_WECO 

When a alarm raised when 8 consecutive points lie on the same side of the mean $ \mu $ was raised.

NONE_WECO 

When no WECO's rule alarm was raised.

COUNT_WECO 

Number of WECO's rules that are implemented.

Examples
testSPC.cpp.

Definition at line 83 of file vpStatisticalTestShewhart.h.

Constructor & Destructor Documentation

◆ vpStatisticalTestShewhart() [1/2]

vpStatisticalTestShewhart::vpStatisticalTestShewhart ( const bool & activateWECOrules = true,
const std::vector< bool > & activatedRules = CONST_ALL_WECO_ACTIVATED,
const unsigned int & nbSamplesForStats = 30 )

Construct a new vpStatisticalTestShewhart object.

Parameters
[in]activateWECOrulesIf true, activate the WECO's rules (NB: it increases the sensitivity of the Shewhart control chart but the false alarm frequency is also increased.)
[in]activatedRulesAn array where true means that the corresponding WECO's rule is activated and false means that it is not.
[in]nbSamplesForStatsThe number of samples to compute the statistics of the signal.

Definition at line 254 of file vpStatisticalTestShewhart.cpp.

References vpStatisticalTestAbstract::init(), m_activateWECOrules, m_alarm, m_idCurrentData, m_nbDataInBuffer, m_oneSigmaNegLim, m_oneSigmaPosLim, m_twoSigmaNegLim, m_twoSigmaPosLim, NONE_WECO, and vpStatisticalTestSigma::vpStatisticalTestSigma().

◆ vpStatisticalTestShewhart() [2/2]

vpStatisticalTestShewhart::vpStatisticalTestShewhart ( const bool & activateWECOrules,
const std::vector< bool > & activatedRules,
const float & mean,
const float & stdev )

Construct a new vpStatisticalTestShewhart object.

Parameters
[in]activateWECOrulesIf true, activate the WECO's rules (NB: it increases the sensitivity of the Shewhart control chart but the false alarm frequency is also increased.)
[in]activatedRulesAn array where true means that the corresponding WECO's rule is activated and false means that it is not.
[in]meanThe expected mean of the signal.
[in]stdevThe expected standard deviation of the signal.

Definition at line 268 of file vpStatisticalTestShewhart.cpp.

References vpStatisticalTestAbstract::init(), m_activateWECOrules, m_alarm, m_idCurrentData, m_nbDataInBuffer, m_oneSigmaNegLim, m_oneSigmaPosLim, m_twoSigmaNegLim, m_twoSigmaPosLim, NONE_WECO, and vpStatisticalTestSigma::vpStatisticalTestSigma().

Member Function Documentation

◆ computeLimits()

void vpStatisticalTestShewhart::computeLimits ( )
protectedvirtual

Compute the upper and lower limits of the test signal.

Reimplemented from vpStatisticalTestSigma.

Definition at line 80 of file vpStatisticalTestShewhart.cpp.

References vpStatisticalTestAbstract::m_limitDown, vpStatisticalTestAbstract::m_limitUp, vpStatisticalTestAbstract::m_mean, m_oneSigmaNegLim, m_oneSigmaPosLim, vpStatisticalTestAbstract::m_stdev, m_twoSigmaNegLim, and m_twoSigmaPosLim.

Referenced by init(), and updateStatistics().

◆ detectDownwardMeanDrift()

vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestShewhart::detectDownwardMeanDrift ( )
protectedvirtual

Detects if a downward mean drift occurred.

Returns
vpMeanDriftType::MEAN_DRIFT_DOWNWARD if a downward mean drift occurred, vpMeanDriftType::MEAN_DRIFT_NONE otherwise.
See also
detectUpwardMeanDrift()

Reimplemented from vpStatisticalTestSigma.

Definition at line 91 of file vpStatisticalTestShewhart.cpp.

References m_activatedWECOrules, m_activateWECOrules, m_alarm, m_idCurrentData, vpStatisticalTestAbstract::m_limitDown, vpStatisticalTestAbstract::m_mean, m_nbDataInBuffer, m_oneSigmaNegLim, m_signal_vec, m_twoSigmaNegLim, vpStatisticalTestAbstract::MEAN_DRIFT_DOWNWARD, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, vpMath::modulo(), NB_DATA_SIGNAL, ONE_SIGMA_WECO, SAME_SIDE_WECO, THREE_SIGMA_WECO, and TWO_SIGMA_WECO.

◆ detectUpwardMeanDrift()

vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestShewhart::detectUpwardMeanDrift ( )
protectedvirtual

Detects if an upward mean drift occurred on the mean.

Returns
vpMeanDriftType::MEAN_DRIFT_UPWARD if an upward mean drift occurred, vpMeanDriftType::MEAN_DRIFT_NONE otherwise.
See also
detectDownwardMeanDrift()

Reimplemented from vpStatisticalTestSigma.

Definition at line 163 of file vpStatisticalTestShewhart.cpp.

References m_activatedWECOrules, m_activateWECOrules, m_alarm, m_idCurrentData, vpStatisticalTestAbstract::m_limitUp, vpStatisticalTestAbstract::m_mean, m_nbDataInBuffer, m_oneSigmaPosLim, m_signal_vec, m_twoSigmaPosLim, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, vpStatisticalTestAbstract::MEAN_DRIFT_UPWARD, vpMath::modulo(), NB_DATA_SIGNAL, ONE_SIGMA_WECO, SAME_SIDE_WECO, THREE_SIGMA_WECO, and TWO_SIGMA_WECO.

◆ getAlarm()

vpWecoRulesAlarm vpStatisticalTestShewhart::getAlarm ( ) const
inline

Get the alarm raised by the last test due to the WECO's rules.

Returns
vpWecoRulesAlarm The type of raised alarm.
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 182 of file vpStatisticalTestShewhart.h.

References getAlarm(), and m_alarm.

Referenced by getAlarm().

◆ getAvailableMeanDriftType()

std::string vpStatisticalTestAbstract::getAvailableMeanDriftType ( const std::string & prefix = "<",
const std::string & sep = " , ",
const std::string & suffix = ">" )
staticinherited

Get the list of available vpMeanDriftType objects that are handled.

Parameters
[in]prefixThe prefix that should be placed before the list.
[in]sepThe separator between each element of the list.
[in]suffixThe suffix that should terminate the list.
Returns
std::string The list of handled type of process tests, presented as a string.
Examples
tutorial-meandrift.cpp.

Definition at line 85 of file vpStatisticalTestAbstract.cpp.

References MEAN_DRIFT_COUNT, and vpMeanDriftTypeToString().

◆ getLimits()

void vpStatisticalTestAbstract::getLimits ( float & limitDown,
float & limitUp ) const
inlineinherited

Get the upper and lower limits of the test signal.

Parameters
[out]limitDownThe lower limit.
[out]limitUpThe upper limit.
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 181 of file vpStatisticalTestAbstract.h.

References m_limitDown, and m_limitUp.

◆ getMean()

float vpStatisticalTestAbstract::getMean ( ) const
inlineinherited

Get the mean used as reference.

Returns
float The mean.
Examples
tutorial-meandrift.cpp.

Definition at line 192 of file vpStatisticalTestAbstract.h.

References m_mean.

◆ getSignal()

virtual float vpStatisticalTestShewhart::getSignal ( ) const
inlineoverridevirtual

Get the last value of the signal.

Returns
float The signal.

Reimplemented from vpStatisticalTestSigma.

Examples
testSPC.cpp.

Definition at line 193 of file vpStatisticalTestShewhart.h.

References m_idCurrentData, and m_signal_vec.

◆ getSignals()

std::vector< float > vpStatisticalTestShewhart::getSignals ( ) const

Get the NB_DATA_SIGNAL last signal values, sorted from the latest [0] to the newest [NB_DATA_SIGNAL - 1].

Returns
std::vector<float> The last NB_DATA_SIGNAL values.
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 282 of file vpStatisticalTestShewhart.cpp.

References m_idCurrentData, m_signal_vec, vpMath::modulo(), and NB_DATA_SIGNAL.

◆ getStdev()

float vpStatisticalTestAbstract::getStdev ( ) const
inlineinherited

Get the standard deviation used as reference.

Returns
float The standard deviation.
Examples
tutorial-meandrift.cpp.

Definition at line 202 of file vpStatisticalTestAbstract.h.

References m_stdev.

◆ init() [1/5]

void vpStatisticalTestAbstract::init ( )
inherited

(Re)Initialize the algorithm.

Definition at line 157 of file vpStatisticalTestAbstract.cpp.

References m_areStatisticsComputed, m_count, m_limitDown, m_limitUp, m_mean, m_nbSamplesForStatistics, m_s, m_stdev, and m_sumForMean.

Referenced by vpStatisticalTestEWMA::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestSigma::init(), vpStatisticalTestSigma::init(), vpStatisticalTestEWMA::setAlpha(), vpStatisticalTestEWMA::vpStatisticalTestEWMA(), vpStatisticalTestMeanAdjustedCUSUM::vpStatisticalTestMeanAdjustedCUSUM(), vpStatisticalTestShewhart::vpStatisticalTestShewhart(), vpStatisticalTestShewhart::vpStatisticalTestShewhart(), vpStatisticalTestSigma::vpStatisticalTestSigma(), and vpStatisticalTestSigma::vpStatisticalTestSigma().

◆ init() [2/5]

void vpStatisticalTestShewhart::init ( const bool & activateWECOrules,
const std::vector< bool > & activatedRules,
const float & mean,
const float & stdev )

(Re)Initialize the test.

Parameters
[in]activateWECOrulesIf true, activate the WECO's rules (NB: it increases the sensitivity of the Shewhart control chart but the false alarm frequency is also increased.)
[in]activatedRulesAn array where true means that the corresponding WECO's rule is activated and false means that it is not.
[in]meanThe expected mean of the signal.
[in]stdevThe expected standard deviation of the signal.

Definition at line 312 of file vpStatisticalTestShewhart.cpp.

References computeLimits(), vpStatisticalTestAbstract::init(), vpStatisticalTestAbstract::m_areStatisticsComputed, vpStatisticalTestAbstract::m_mean, and vpStatisticalTestAbstract::m_stdev.

◆ init() [3/5]

void vpStatisticalTestShewhart::init ( const bool & activateWECOrules,
const std::vector< bool > & activatedRules = CONST_ALL_WECO_ACTIVATED,
const unsigned int & nbSamplesForStats = 30 )

(Re)Initialize the test.

Parameters
[in]activateWECOrulesIf true, activate the WECO's rules (NB: it increases the sensitivity of the Shewhart control chart but the false alarm frequency is also increased.)
[in]activatedRulesAn array where true means that the corresponding WECO's rule is activated and false means that it is not.
[in]nbSamplesForStatsThe number of samples to compute the statistics of the signal.
Examples
testSPC.cpp.

Definition at line 292 of file vpStatisticalTestShewhart.cpp.

References COUNT_WECO, vpException::dimensionError, vpStatisticalTestAbstract::init(), m_activatedWECOrules, m_activateWECOrules, m_alarm, m_idCurrentData, m_nbDataInBuffer, m_oneSigmaNegLim, m_oneSigmaPosLim, m_signal_vec, m_twoSigmaNegLim, m_twoSigmaPosLim, NB_DATA_SIGNAL, and NONE_WECO.

◆ init() [4/5]

void vpStatisticalTestSigma::init ( const float & h,
const float & mean,
const float & stdev )
inherited

(Re)Initialize the test.

Parameters
[in]hThe alarm factor applied to the standard deviation to compute the limits.
[in]meanThe expected mean of the signal.
[in]stdevThe expected standard deviation of the signal.

Definition at line 105 of file vpStatisticalTestSigma.cpp.

References computeLimits(), vpStatisticalTestAbstract::init(), vpStatisticalTestAbstract::m_areStatisticsComputed, m_h, vpStatisticalTestAbstract::m_mean, m_signal, and vpStatisticalTestAbstract::m_stdev.

◆ init() [5/5]

void vpStatisticalTestSigma::init ( const float & h = 3.f,
const unsigned int & nbSamplesForStats = 30 )
inherited

(Re)Initialize the test.

Parameters
[in]hThe alarm factor applied to the standard deviation to compute the limits.
[in]nbSamplesForStatsThe number of samples to compute the statistics of the signal.

Definition at line 97 of file vpStatisticalTestSigma.cpp.

References vpStatisticalTestAbstract::init(), m_h, m_signal, and vpStatisticalTestAbstract::setNbSamplesForStat().

◆ print()

void vpStatisticalTestAbstract::print ( const vpMeanDriftType & type)
staticinherited

Print the message corresponding to the type of mean drift.

Parameters
[in]typeThe type of mean drift.

Definition at line 98 of file vpStatisticalTestAbstract.cpp.

References vpMeanDriftTypeToString().

◆ setMinStdev()

void vpStatisticalTestAbstract::setMinStdev ( const float & stdevmin)
inlineinherited

Set the minimum value of the standard deviation that is expected. The computed standard deviation cannot be lower this value if set.

Parameters
[in]stdevminThe minimum value of the standard deviation that is expected.

Definition at line 226 of file vpStatisticalTestAbstract.h.

References m_stdevmin.

◆ setNbSamplesForStat()

void vpStatisticalTestAbstract::setNbSamplesForStat ( const unsigned int & nbSamples)
inherited

Set the number of samples required to compute the mean and standard deviation of the signal and allocate the memory accordingly.

Parameters
[in]nbSamplesThe number of samples we want to use.

Definition at line 193 of file vpStatisticalTestAbstract.cpp.

References m_nbSamplesForStatistics, and m_s.

Referenced by vpStatisticalTestEWMA::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestSigma::init(), and operator=().

◆ testDownUpwardMeanDrift()

vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestAbstract::testDownUpwardMeanDrift ( const float & signal)
inherited

Test if a downward or an upward mean drift occurred according to the new value of the signal.

Parameters
[in]signalThe new value of the signal.
Returns
vpMeanDriftType The type of mean drift that occurred.
See also
testDownwardMeanDrift() testUpwardMeanDrift()
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 202 of file vpStatisticalTestAbstract.cpp.

References detectDownwardMeanDrift(), detectUpwardMeanDrift(), m_areStatisticsComputed, MEAN_DRIFT_BOTH, MEAN_DRIFT_NONE, updateStatistics(), and updateTestSignals().

◆ testDownwardMeanDrift()

vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestAbstract::testDownwardMeanDrift ( const float & signal)
inherited

Test if a downward mean drift occurred according to the new value of the signal.

Parameters
[in]signalThe new value of the signal.
Returns
vpMeanDriftType The type of mean drift that occurred.
See also
testUpwardMeanDrift()

Definition at line 227 of file vpStatisticalTestAbstract.cpp.

References detectDownwardMeanDrift(), m_areStatisticsComputed, MEAN_DRIFT_NONE, updateStatistics(), and updateTestSignals().

◆ testUpwardMeanDrift()

vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestAbstract::testUpwardMeanDrift ( const float & signal)
inherited

Test if an upward mean drift occurred according to the new value of the signal.

Parameters
[in]signalThe new value of the signal.
Returns
vpMeanDriftType The type of mean drift that occurred.
See also
testDownwardMeanDrift()

Definition at line 239 of file vpStatisticalTestAbstract.cpp.

References detectUpwardMeanDrift(), m_areStatisticsComputed, MEAN_DRIFT_NONE, updateStatistics(), and updateTestSignals().

◆ updateStatistics()

bool vpStatisticalTestShewhart::updateStatistics ( const float & signal)
protectedvirtual

Update m_s and if enough values are available, compute the mean, the standard deviation and the limits.

Parameters
[in]signalThe new value of the signal to monitor.

Reimplemented from vpStatisticalTestSigma.

Definition at line 235 of file vpStatisticalTestShewhart.cpp.

References computeLimits(), vpStatisticalTestAbstract::updateStatistics(), and updateTestSignals().

◆ updateTestSignals()

void vpStatisticalTestShewhart::updateTestSignals ( const float & signal)
protectedvirtual

Update the test signals.

Parameters
[in]signalThe new value of the signal to monitor.

Reimplemented from vpStatisticalTestSigma.

Definition at line 245 of file vpStatisticalTestShewhart.cpp.

References m_idCurrentData, m_nbDataInBuffer, m_signal_vec, and NB_DATA_SIGNAL.

Referenced by updateStatistics().

◆ vpMeanDriftTypeFromString()

vpStatisticalTestAbstract::vpMeanDriftType vpStatisticalTestAbstract::vpMeanDriftTypeFromString ( const std::string & name)
staticinherited

Cast a string into a vpMeanDriftType.

Parameters
[in]nameThe name of the mean drift.
Returns
vpMeanDriftType The corresponding vpMeanDriftType.
Examples
tutorial-meandrift.cpp.

Definition at line 68 of file vpStatisticalTestAbstract.cpp.

References MEAN_DRIFT_COUNT, MEAN_DRIFT_UNKNOWN, and vpMeanDriftTypeToString().

◆ vpMeanDriftTypeToString()

BEGIN_VISP_NAMESPACE std::string vpStatisticalTestAbstract::vpMeanDriftTypeToString ( const vpMeanDriftType & type)
staticinherited

Cast a vpMeanDriftType into a string.

Parameters
[in]typeThe type of mean drift.
Returns
std::string The corresponding message.
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 42 of file vpStatisticalTestAbstract.cpp.

References vpException::fatalError, MEAN_DRIFT_BOTH, MEAN_DRIFT_DOWNWARD, MEAN_DRIFT_NONE, MEAN_DRIFT_UNKNOWN, and MEAN_DRIFT_UPWARD.

Referenced by getAvailableMeanDriftType(), print(), and vpMeanDriftTypeFromString().

◆ vpWecoRulesAlarmToString()

std::string vpStatisticalTestShewhart::vpWecoRulesAlarmToString ( const vpWecoRulesAlarm & alarm)
static
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 54 of file vpStatisticalTestShewhart.cpp.

References COUNT_WECO, NONE_WECO, ONE_SIGMA_WECO, SAME_SIDE_WECO, THREE_SIGMA_WECO, and TWO_SIGMA_WECO.

Member Data Documentation

◆ CONST_ALL_WECO_ACTIVATED

VP_ATTRIBUTE_NO_DESTROY const std::vector<bool> vpStatisticalTestShewhart::CONST_ALL_WECO_ACTIVATED = std::vector<bool>(COUNT_WECO -1, true)
inlinestatic
Examples
testSPC.cpp, and tutorial-meandrift.cpp.

Definition at line 96 of file vpStatisticalTestShewhart.h.

◆ m_activatedWECOrules

std::vector<bool> vpStatisticalTestShewhart::m_activatedWECOrules
protected

The WECO's rules that are activated. The more are activated, the higher the sensitivity of the Shewhart control chart is but the higher the false alarm frequency is.

Definition at line 107 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), and init().

◆ m_activateWECOrules

bool vpStatisticalTestShewhart::m_activateWECOrules
protected

If true, activate the WECO's rules (NB: it increases the sensitivity of the Shewhart control chart but the false alarm frequency is also increased.)

Definition at line 105 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), init(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_alarm

vpWecoRulesAlarm vpStatisticalTestShewhart::m_alarm
protected

The type of alarm raised due to WECO's rules.

Definition at line 111 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), getAlarm(), init(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_areStatisticsComputed

bool vpStatisticalTestAbstract::m_areStatisticsComputed
protectedinherited

Set to true once the mean and the standard deviation are available.

Definition at line 114 of file vpStatisticalTestAbstract.h.

Referenced by init(), vpStatisticalTestEWMA::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestSigma::init(), operator=(), testDownUpwardMeanDrift(), testDownwardMeanDrift(), testUpwardMeanDrift(), updateStatistics(), vpStatisticalTestHinkley::updateStatistics(), and vpStatisticalTestAbstract().

◆ m_count

float vpStatisticalTestAbstract::m_count
protectedinherited

Current number of data used to compute the mean and the standard deviation.

Definition at line 115 of file vpStatisticalTestAbstract.h.

Referenced by vpStatisticalTestHinkley::computeMean(), init(), operator=(), updateStatistics(), vpStatisticalTestHinkley::updateTestSignals(), and vpStatisticalTestAbstract().

◆ m_h

float vpStatisticalTestSigma::m_h
protectedinherited

The alarm factor applied to the standard deviation to compute the limits.

Definition at line 78 of file vpStatisticalTestSigma.h.

Referenced by computeLimits(), init(), init(), vpStatisticalTestSigma(), and vpStatisticalTestSigma().

◆ m_idCurrentData

unsigned int vpStatisticalTestShewhart::m_idCurrentData
protected

The index of the current data in m_signal.

Definition at line 110 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), getSignal(), getSignals(), init(), updateTestSignals(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_limitDown

float vpStatisticalTestAbstract::m_limitDown
protectedinherited

Upper limit for the test signal m_wt.

Definition at line 116 of file vpStatisticalTestAbstract.h.

Referenced by vpStatisticalTestEWMA::computeDeltaAndLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestSigma::computeLimits(), vpStatisticalTestEWMA::detectDownwardMeanDrift(), vpStatisticalTestMeanAdjustedCUSUM::detectDownwardMeanDrift(), vpStatisticalTestShewhart::detectDownwardMeanDrift(), vpStatisticalTestSigma::detectDownwardMeanDrift(), getLimits(), init(), operator=(), vpStatisticalTestHinkley::setAlpha(), vpStatisticalTestMeanAdjustedCUSUM::setLimits(), vpStatisticalTestMeanAdjustedCUSUM::updateStatistics(), and vpStatisticalTestAbstract().

◆ m_limitUp

float vpStatisticalTestAbstract::m_limitUp
protectedinherited

Lower limit for the test signal m_wt

Definition at line 117 of file vpStatisticalTestAbstract.h.

Referenced by vpStatisticalTestEWMA::computeDeltaAndLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestSigma::computeLimits(), vpStatisticalTestEWMA::detectUpwardMeanDrift(), vpStatisticalTestMeanAdjustedCUSUM::detectUpwardMeanDrift(), vpStatisticalTestShewhart::detectUpwardMeanDrift(), vpStatisticalTestSigma::detectUpwardMeanDrift(), getLimits(), init(), operator=(), vpStatisticalTestHinkley::setAlpha(), vpStatisticalTestMeanAdjustedCUSUM::setLimits(), vpStatisticalTestMeanAdjustedCUSUM::updateStatistics(), and vpStatisticalTestAbstract().

◆ m_mean

float vpStatisticalTestAbstract::m_mean
protectedinherited

Mean of the monitored signal.

Definition at line 118 of file vpStatisticalTestAbstract.h.

Referenced by vpStatisticalTestEWMA::computeDeltaAndLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestSigma::computeLimits(), vpStatisticalTestHinkley::computeMean(), vpStatisticalTestHinkley::computeSk(), vpStatisticalTestHinkley::computeTk(), vpStatisticalTestShewhart::detectDownwardMeanDrift(), vpStatisticalTestShewhart::detectUpwardMeanDrift(), getMean(), init(), vpStatisticalTestEWMA::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestSigma::init(), operator=(), updateStatistics(), vpStatisticalTestEWMA::updateStatistics(), vpStatisticalTestMeanAdjustedCUSUM::updateTestSignals(), and vpStatisticalTestAbstract().

◆ m_nbDataInBuffer

unsigned int vpStatisticalTestShewhart::m_nbDataInBuffer
protected

Indicate how many data are available in the circular buffer.

Definition at line 103 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), init(), updateTestSignals(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_nbSamplesForStatistics

unsigned int vpStatisticalTestAbstract::m_nbSamplesForStatistics
protectedinherited

Number of samples to use to compute the mean and the standard deviation.

Definition at line 119 of file vpStatisticalTestAbstract.h.

Referenced by init(), operator=(), setNbSamplesForStat(), updateStatistics(), and vpStatisticalTestAbstract().

◆ m_oneSigmaNegLim

float vpStatisticalTestShewhart::m_oneSigmaNegLim
protected

The $ \mu - \sigma $ threshold.

Definition at line 112 of file vpStatisticalTestShewhart.h.

Referenced by computeLimits(), detectDownwardMeanDrift(), init(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_oneSigmaPosLim

float vpStatisticalTestShewhart::m_oneSigmaPosLim
protected

The $ \mu + \sigma $ threshold.

Definition at line 113 of file vpStatisticalTestShewhart.h.

Referenced by computeLimits(), detectUpwardMeanDrift(), init(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_s

float* vpStatisticalTestAbstract::m_s
protectedinherited

Array that keeps the samples used to compute the mean and standard deviation.

Definition at line 120 of file vpStatisticalTestAbstract.h.

Referenced by init(), operator=(), setNbSamplesForStat(), updateStatistics(), vpStatisticalTestAbstract(), and ~vpStatisticalTestAbstract().

◆ m_signal

float vpStatisticalTestSigma::m_signal
protectedinherited

The last value of the signal.

Definition at line 79 of file vpStatisticalTestSigma.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), getSignal(), init(), init(), and updateTestSignals().

◆ m_signal_vec

float vpStatisticalTestShewhart::m_signal_vec[NB_DATA_SIGNAL]
protected

The last values of the signal.

Definition at line 104 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), getSignal(), getSignals(), init(), and updateTestSignals().

◆ m_stdev

float vpStatisticalTestAbstract::m_stdev
protectedinherited

Standard deviation of the monitored signal.

Definition at line 121 of file vpStatisticalTestAbstract.h.

Referenced by vpStatisticalTestHinkley::computeAlphaDelta(), vpStatisticalTestEWMA::computeDeltaAndLimits(), vpStatisticalTestMeanAdjustedCUSUM::computeDeltaAndLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestSigma::computeLimits(), getStdev(), init(), vpStatisticalTestEWMA::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestSigma::init(), operator=(), updateStatistics(), and vpStatisticalTestAbstract().

◆ m_stdevmin

float vpStatisticalTestAbstract::m_stdevmin
protectedinherited

Minimum allowed standard deviation of the monitored signal.

Definition at line 122 of file vpStatisticalTestAbstract.h.

Referenced by setMinStdev(), updateStatistics(), and vpStatisticalTestAbstract().

◆ m_sumForMean

float vpStatisticalTestAbstract::m_sumForMean
protectedinherited

Sum of the samples used to compute the mean and standard deviation.

Definition at line 123 of file vpStatisticalTestAbstract.h.

Referenced by init(), vpStatisticalTestMeanAdjustedCUSUM::init(), operator=(), updateStatistics(), and vpStatisticalTestAbstract().

◆ m_twoSigmaNegLim

float vpStatisticalTestShewhart::m_twoSigmaNegLim
protected

The $ \mu - 2 \sigma $ threshold.

Definition at line 114 of file vpStatisticalTestShewhart.h.

Referenced by computeLimits(), detectDownwardMeanDrift(), init(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ m_twoSigmaPosLim

float vpStatisticalTestShewhart::m_twoSigmaPosLim
protected

The $ \mu + 2 \sigma $ threshold.

Definition at line 115 of file vpStatisticalTestShewhart.h.

Referenced by computeLimits(), detectUpwardMeanDrift(), init(), vpStatisticalTestShewhart(), and vpStatisticalTestShewhart().

◆ NB_DATA_SIGNAL

BEGIN_VISP_NAMESPACE const unsigned int vpStatisticalTestShewhart::NB_DATA_SIGNAL = 8
static
Examples
testSPC.cpp.

Definition at line 100 of file vpStatisticalTestShewhart.h.

Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), getSignals(), init(), and updateTestSignals().