Visual Servoing Platform
version 3.6.1 under development (2024-11-15)
|
#include <visp3/core/vpStatisticalTestSigma.h>
Public Types | |
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 | |
vpStatisticalTestSigma (const float &h=3.f, const unsigned int &nbSamplesForStats=30) | |
vpStatisticalTestSigma (const float &h, const float &mean, const float &stdev) | |
virtual float | getSignal () const |
void | init (const float &h=3.f, const unsigned int &nbSamplesForStats=30) |
void | init (const float &h, const float &mean, const float &stdev) |
void | getLimits (float &limitDown, float &limitUp) const |
float | getMean () const |
float | getStdev () const |
void | init () |
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 | 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) |
Protected Member Functions | |
virtual void | computeLimits () |
virtual vpMeanDriftType | detectDownwardMeanDrift () override |
virtual vpMeanDriftType | detectUpwardMeanDrift () override |
virtual bool | updateStatistics (const float &signal) override |
virtual void | updateTestSignals (const float &signal) override |
Protected Attributes | |
float | m_h |
float | m_s |
bool | m_areStatisticsComputed |
float | m_count |
float | m_limitDown |
float | m_limitUp |
float | m_mean |
unsigned int | m_nbSamplesForStatistics |
float | m_stdev |
float | m_stdevmin |
float | m_sumForMean |
Class that permits a simple test comparing the current value to the standard deviation of the signal.
Be the signal to monitor, and the mean and standard deviation of this signal when it is "in control".
Be a user-defined alarm factor.
A downward alarm is raised if:
An upward alarm is raised if:
is often set to 3 if we assume the follows a normal distribution.
To detect only downward drifts of the input signal use testDownwardMeanDrift().To detect only upward drifts in use testUpwardMeanDrift(). To detect both, downward and upward drifts use testDownUpwardMeanDrift().
Definition at line 69 of file vpStatisticalTestSigma.h.
|
inherited |
Enum that indicates if a drift of the mean occurred.
|
inherited |
Enum that indicates if a drift of the mean occurred.
Definition at line 63 of file vpStatisticalTestAbstract.h.
vpStatisticalTestSigma::vpStatisticalTestSigma | ( | const float & | h = 3.f , |
const unsigned int & | nbSamplesForStats = 30 |
||
) |
Construct a new vpStatisticalTestSigma object.
[in] | h | The alarm factor applied to the standard deviation to compute the limits. |
[in] | nbSamplesForStats | The number of samples to compute the statistics of the signal. |
Definition at line 83 of file vpStatisticalTestSigma.cpp.
References vpStatisticalTestAbstract::init().
vpStatisticalTestSigma::vpStatisticalTestSigma | ( | const float & | h, |
const float & | mean, | ||
const float & | stdev | ||
) |
Construct a new vpStatisticalTestSigma object.
[in] | h | The alarm factor applied to the standard deviation to compute the limits. |
[in] | mean | The expected mean of the signal. |
[in] | stdev | The expected standard deviation of the signal. |
Definition at line 90 of file vpStatisticalTestSigma.cpp.
References vpStatisticalTestAbstract::init().
|
protectedvirtual |
Compute the upper and lower limits of the test signal.
Reimplemented in vpStatisticalTestShewhart.
Definition at line 42 of file vpStatisticalTestSigma.cpp.
References m_h, vpStatisticalTestAbstract::m_limitDown, vpStatisticalTestAbstract::m_limitUp, vpStatisticalTestAbstract::m_mean, and vpStatisticalTestAbstract::m_stdev.
Referenced by init(), and updateStatistics().
|
overrideprotectedvirtual |
Detects if a downward mean drift occurred.
Implements vpStatisticalTestAbstract.
Reimplemented in vpStatisticalTestShewhart.
Definition at line 49 of file vpStatisticalTestSigma.cpp.
References vpStatisticalTestAbstract::m_limitDown, m_s, vpStatisticalTestAbstract::MEAN_DRIFT_DOWNWARD, and vpStatisticalTestAbstract::MEAN_DRIFT_NONE.
|
overrideprotectedvirtual |
Detects if an upward mean drift occurred on the mean.
Implements vpStatisticalTestAbstract.
Reimplemented in vpStatisticalTestShewhart.
Definition at line 59 of file vpStatisticalTestSigma.cpp.
References vpStatisticalTestAbstract::m_limitUp, m_s, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, and vpStatisticalTestAbstract::MEAN_DRIFT_UPWARD.
|
staticinherited |
Get the list of available vpMeanDriftType objects that are handled.
[in] | prefix | The prefix that should be placed before the list. |
[in] | sep | The separator between each element of the list. |
[in] | suffix | The suffix that should terminate the list. |
Definition at line 82 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::MEAN_DRIFT_COUNT, and vpStatisticalTestAbstract::vpMeanDriftTypeToString().
|
inlineinherited |
Get the upper and lower limits of the test signal.
[out] | limitDown | The lower limit. |
[out] | limitUp | The upper limit. |
Definition at line 175 of file vpStatisticalTestAbstract.h.
|
inlineinherited |
Get the mean used as reference.
Definition at line 186 of file vpStatisticalTestAbstract.h.
|
inlinevirtual |
Get the last value of the signal.
Reimplemented in vpStatisticalTestShewhart.
Definition at line 151 of file vpStatisticalTestSigma.h.
References vpStatisticalTestAbstract::m_s.
|
inlineinherited |
Get the standard deviation used as reference.
Definition at line 196 of file vpStatisticalTestAbstract.h.
|
inherited |
(Re)Initialize the algorithm.
Definition at line 154 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::m_areStatisticsComputed, vpStatisticalTestAbstract::m_count, vpStatisticalTestAbstract::m_limitDown, vpStatisticalTestAbstract::m_limitUp, vpStatisticalTestAbstract::m_mean, vpStatisticalTestAbstract::m_nbSamplesForStatistics, vpStatisticalTestAbstract::m_s, vpStatisticalTestAbstract::m_stdev, and vpStatisticalTestAbstract::m_sumForMean.
Referenced by vpStatisticalTestHinkley::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), init(), vpStatisticalTestEWMA::setAlpha(), vpStatisticalTestEWMA::vpStatisticalTestEWMA(), vpStatisticalTestMeanAdjustedCUSUM::vpStatisticalTestMeanAdjustedCUSUM(), vpStatisticalTestShewhart::vpStatisticalTestShewhart(), and vpStatisticalTestSigma().
void vpStatisticalTestSigma::init | ( | const float & | h, |
const float & | mean, | ||
const float & | stdev | ||
) |
(Re)Initialize the test.
[in] | h | The alarm factor applied to the standard deviation to compute the limits. |
[in] | mean | The expected mean of the signal. |
[in] | stdev | The 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_s, and vpStatisticalTestAbstract::m_stdev.
void vpStatisticalTestSigma::init | ( | const float & | h = 3.f , |
const unsigned int & | nbSamplesForStats = 30 |
||
) |
(Re)Initialize the test.
[in] | h | The alarm factor applied to the standard deviation to compute the limits. |
[in] | nbSamplesForStats | The number of samples to compute the statistics of the signal. |
Definition at line 97 of file vpStatisticalTestSigma.cpp.
References vpStatisticalTestAbstract::init(), m_h, m_s, and vpStatisticalTestAbstract::setNbSamplesForStat().
|
staticinherited |
Print the message corresponding to the type of mean drift.
[in] | type | The type of mean drift. |
Definition at line 95 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::vpMeanDriftTypeToString().
|
inlineinherited |
Set the minimum value of the standard deviation that is expected. The computed standard deviation cannot be lower this value if set.
[in] | stdevmin | The minimum value of the standard deviation that is expected. |
Definition at line 220 of file vpStatisticalTestAbstract.h.
|
inherited |
Set the number of samples required to compute the mean and standard deviation of the signal and allocate the memory accordingly.
[in] | nbSamples | The number of samples we want to use. |
Definition at line 190 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::m_nbSamplesForStatistics, and vpStatisticalTestAbstract::m_s.
Referenced by vpStatisticalTestHinkley::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), init(), and vpStatisticalTestAbstract::operator=().
|
inherited |
Test if a downward or an upward mean drift occurred according to the new value of the signal.
[in] | signal | The new value of the signal. |
Definition at line 199 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::detectDownwardMeanDrift(), vpStatisticalTestAbstract::detectUpwardMeanDrift(), vpStatisticalTestAbstract::m_areStatisticsComputed, vpStatisticalTestAbstract::MEAN_DRIFT_BOTH, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, vpStatisticalTestAbstract::updateStatistics(), and vpStatisticalTestAbstract::updateTestSignals().
|
inherited |
Test if a downward mean drift occurred according to the new value of the signal.
[in] | signal | The new value of the signal. |
Definition at line 224 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::detectDownwardMeanDrift(), vpStatisticalTestAbstract::m_areStatisticsComputed, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, vpStatisticalTestAbstract::updateStatistics(), and vpStatisticalTestAbstract::updateTestSignals().
|
inherited |
Test if an upward mean drift occurred according to the new value of the signal.
[in] | signal | The new value of the signal. |
Definition at line 236 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::detectUpwardMeanDrift(), vpStatisticalTestAbstract::m_areStatisticsComputed, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, vpStatisticalTestAbstract::updateStatistics(), and vpStatisticalTestAbstract::updateTestSignals().
|
overrideprotectedvirtual |
Update m_s and if enough values are available, compute the mean, the standard deviation and the limits.
[in] | signal | The new value of the signal to monitor. |
Reimplemented from vpStatisticalTestAbstract.
Reimplemented in vpStatisticalTestShewhart.
Definition at line 69 of file vpStatisticalTestSigma.cpp.
References computeLimits(), and vpStatisticalTestAbstract::updateStatistics().
|
overrideprotectedvirtual |
Update the test signals.
[in] | signal | The new value of the signal to monitor. |
Implements vpStatisticalTestAbstract.
Reimplemented in vpStatisticalTestShewhart.
Definition at line 78 of file vpStatisticalTestSigma.cpp.
References m_s.
|
staticinherited |
Cast a string into a vpMeanDriftType.
[in] | name | The name of the mean drift. |
Definition at line 65 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::MEAN_DRIFT_COUNT, vpStatisticalTestAbstract::MEAN_DRIFT_UNKNOWN, and vpStatisticalTestAbstract::vpMeanDriftTypeToString().
|
staticinherited |
Cast a vpMeanDriftType into a string.
[in] | type | The type of mean drift. |
Definition at line 41 of file vpStatisticalTestAbstract.cpp.
References vpStatisticalTestAbstract::MEAN_DRIFT_BOTH, vpStatisticalTestAbstract::MEAN_DRIFT_DOWNWARD, vpStatisticalTestAbstract::MEAN_DRIFT_NONE, vpStatisticalTestAbstract::MEAN_DRIFT_UNKNOWN, and vpStatisticalTestAbstract::MEAN_DRIFT_UPWARD.
Referenced by vpStatisticalTestAbstract::getAvailableMeanDriftType(), vpStatisticalTestAbstract::print(), and vpStatisticalTestAbstract::vpMeanDriftTypeFromString().
|
protectedinherited |
Set to true once the mean and the standard deviation are available.
Definition at line 108 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestAbstract::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), init(), vpStatisticalTestAbstract::operator=(), vpStatisticalTestAbstract::testDownUpwardMeanDrift(), vpStatisticalTestAbstract::testDownwardMeanDrift(), vpStatisticalTestAbstract::testUpwardMeanDrift(), vpStatisticalTestAbstract::updateStatistics(), and vpStatisticalTestHinkley::updateStatistics().
|
protectedinherited |
Current number of data used to compute the mean and the standard deviation.
Definition at line 109 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestHinkley::computeMean(), vpStatisticalTestAbstract::init(), vpStatisticalTestAbstract::operator=(), vpStatisticalTestAbstract::updateStatistics(), and vpStatisticalTestHinkley::updateTestSignals().
|
protected |
The alarm factor applied to the standard deviation to compute the limits.
Definition at line 72 of file vpStatisticalTestSigma.h.
Referenced by computeLimits(), and init().
|
protectedinherited |
Upper limit for the test signal m_wt.
Definition at line 110 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestEWMA::computeDeltaAndLimits(), computeLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestEWMA::detectDownwardMeanDrift(), vpStatisticalTestMeanAdjustedCUSUM::detectDownwardMeanDrift(), vpStatisticalTestShewhart::detectDownwardMeanDrift(), detectDownwardMeanDrift(), vpStatisticalTestAbstract::init(), vpStatisticalTestAbstract::operator=(), vpStatisticalTestHinkley::setAlpha(), and vpStatisticalTestMeanAdjustedCUSUM::updateStatistics().
|
protectedinherited |
Lower limit for the test signal m_wt
Definition at line 111 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestEWMA::computeDeltaAndLimits(), computeLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestEWMA::detectUpwardMeanDrift(), vpStatisticalTestMeanAdjustedCUSUM::detectUpwardMeanDrift(), vpStatisticalTestShewhart::detectUpwardMeanDrift(), detectUpwardMeanDrift(), vpStatisticalTestAbstract::init(), vpStatisticalTestAbstract::operator=(), vpStatisticalTestHinkley::setAlpha(), and vpStatisticalTestMeanAdjustedCUSUM::updateStatistics().
|
protectedinherited |
Mean of the monitored signal.
Definition at line 112 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestEWMA::computeDeltaAndLimits(), computeLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestHinkley::computeMean(), vpStatisticalTestHinkley::computeSk(), vpStatisticalTestHinkley::computeTk(), vpStatisticalTestShewhart::detectDownwardMeanDrift(), vpStatisticalTestShewhart::detectUpwardMeanDrift(), vpStatisticalTestAbstract::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), init(), vpStatisticalTestAbstract::operator=(), vpStatisticalTestAbstract::updateStatistics(), vpStatisticalTestEWMA::updateStatistics(), and vpStatisticalTestMeanAdjustedCUSUM::updateTestSignals().
|
protectedinherited |
Number of samples to use to compute the mean and the standard deviation.
Definition at line 113 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestAbstract::init(), vpStatisticalTestAbstract::operator=(), vpStatisticalTestAbstract::setNbSamplesForStat(), and vpStatisticalTestAbstract::updateStatistics().
|
protected |
The last value of the signal.
Definition at line 73 of file vpStatisticalTestSigma.h.
Referenced by detectDownwardMeanDrift(), detectUpwardMeanDrift(), init(), and updateTestSignals().
|
protectedinherited |
Standard deviation of the monitored signal.
Definition at line 115 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestHinkley::computeAlphaDelta(), vpStatisticalTestEWMA::computeDeltaAndLimits(), vpStatisticalTestMeanAdjustedCUSUM::computeDeltaAndLimits(), computeLimits(), vpStatisticalTestShewhart::computeLimits(), vpStatisticalTestAbstract::init(), vpStatisticalTestShewhart::init(), vpStatisticalTestEWMA::init(), vpStatisticalTestHinkley::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), init(), vpStatisticalTestAbstract::operator=(), and vpStatisticalTestAbstract::updateStatistics().
|
protectedinherited |
Minimum allowed standard deviation of the monitored signal.
Definition at line 116 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestAbstract::updateStatistics().
|
protectedinherited |
Sum of the samples used to compute the mean and standard deviation.
Definition at line 117 of file vpStatisticalTestAbstract.h.
Referenced by vpStatisticalTestAbstract::init(), vpStatisticalTestMeanAdjustedCUSUM::init(), vpStatisticalTestAbstract::operator=(), and vpStatisticalTestAbstract::updateStatistics().