OpenCV  3.3.0-dev
Open Source Computer Vision
Public Types | Public Member Functions | Static Public Member Functions | List of all members
cv::ml::SVMSGD Class Referenceabstract

Stochastic Gradient Descent SVM classifier. More...

#include "ml.hpp"

Inheritance diagram for cv::ml::SVMSGD:
cv::ml::StatModel cv::Algorithm

Public Types

enum  MarginType {
  SOFT_MARGIN,
  HARD_MARGIN
}
 
enum  SvmsgdType {
  SGD,
  ASGD
}
 
- Public Types inherited from cv::ml::StatModel
enum  Flags {
  UPDATE_MODEL = 1,
  RAW_OUTPUT =1,
  COMPRESSED_INPUT =2,
  PREPROCESSED_INPUT =4
}
 

Public Member Functions

virtual float getInitialStepSize () const =0
 Parameter initialStepSize of a SVMSGD optimization problem. More...
 
virtual float getMarginRegularization () const =0
 Parameter marginRegularization of a SVMSGD optimization problem. More...
 
virtual int getMarginType () const =0
 Margin type, one of SVMSGD::MarginType. More...
 
virtual float getShift ()=0
 
virtual float getStepDecreasingPower () const =0
 Parameter stepDecreasingPower of a SVMSGD optimization problem. More...
 
virtual int getSvmsgdType () const =0
 Algorithm type, one of SVMSGD::SvmsgdType. More...
 
virtual TermCriteria getTermCriteria () const =0
 Termination criteria of the training algorithm. You can specify the maximum number of iterations (maxCount) and/or how much the error could change between the iterations to make the algorithm continue (epsilon). More...
 
virtual Mat getWeights ()=0
 
virtual void setInitialStepSize (float InitialStepSize)=0
 Parameter initialStepSize of a SVMSGD optimization problem. More...
 
virtual void setMarginRegularization (float marginRegularization)=0
 Parameter marginRegularization of a SVMSGD optimization problem. More...
 
virtual void setMarginType (int marginType)=0
 Margin type, one of SVMSGD::MarginType. More...
 
virtual void setOptimalParameters (int svmsgdType=SVMSGD::ASGD, int marginType=SVMSGD::SOFT_MARGIN)=0
 Function sets optimal parameters values for chosen SVM SGD model. More...
 
virtual void setStepDecreasingPower (float stepDecreasingPower)=0
 Parameter stepDecreasingPower of a SVMSGD optimization problem. More...
 
virtual void setSvmsgdType (int svmsgdType)=0
 Algorithm type, one of SVMSGD::SvmsgdType. More...
 
virtual void setTermCriteria (const cv::TermCriteria &val)=0
 Termination criteria of the training algorithm. You can specify the maximum number of iterations (maxCount) and/or how much the error could change between the iterations to make the algorithm continue (epsilon). More...
 
- Public Member Functions inherited from cv::ml::StatModel
virtual float calcError (const Ptr< TrainData > &data, bool test, OutputArray resp) const
 Computes error on the training or test dataset. More...
 
virtual bool empty () const
 Returns true if the Algorithm is empty (e.g. in the very beginning or after unsuccessful read. More...
 
virtual int getVarCount () const =0
 Returns the number of variables in training samples. More...
 
virtual bool isClassifier () const =0
 Returns true if the model is classifier. More...
 
virtual bool isTrained () const =0
 Returns true if the model is trained. More...
 
virtual float predict (InputArray samples, OutputArray results=noArray(), int flags=0) const =0
 Predicts response(s) for the provided sample(s) More...
 
virtual bool train (const Ptr< TrainData > &trainData, int flags=0)
 Trains the statistical model. More...
 
virtual bool train (InputArray samples, int layout, InputArray responses)
 Trains the statistical model. More...
 
- Public Member Functions inherited from cv::Algorithm
 Algorithm ()
 
virtual ~Algorithm ()
 
virtual void clear ()
 Clears the algorithm state. More...
 
virtual String getDefaultName () const
 
virtual void read (const FileNode &fn)
 Reads algorithm parameters from a file storage. More...
 
virtual void save (const String &filename) const
 
virtual void write (FileStorage &fs) const
 Stores algorithm parameters in a file storage. More...
 

Static Public Member Functions

static Ptr< SVMSGDcreate ()
 Creates empty model. Use StatModel::train to train the model. Since SVMSGD has several parameters, you may want to find the best parameters for your problem or use setOptimalParameters() to set some default parameters. More...
 
static Ptr< SVMSGDload (const String &filepath, const String &nodeName=String())
 Loads and creates a serialized SVMSGD from a file. More...
 
- Static Public Member Functions inherited from cv::ml::StatModel
template<typename _Tp >
static Ptr< _Tp > train (const Ptr< TrainData > &data, int flags=0)
 Create and train model with default parameters. More...
 
- Static Public Member Functions inherited from cv::Algorithm
template<typename _Tp >
static Ptr< _Tp > load (const String &filename, const String &objname=String())
 Loads algorithm from the file. More...
 
template<typename _Tp >
static Ptr< _Tp > loadFromString (const String &strModel, const String &objname=String())
 Loads algorithm from a String. More...
 
template<typename _Tp >
static Ptr< _Tp > read (const FileNode &fn)
 Reads algorithm from the file node. More...
 

Additional Inherited Members

- Protected Member Functions inherited from cv::Algorithm
void writeFormat (FileStorage &fs) const
 

Detailed Description

Stochastic Gradient Descent SVM classifier.

SVMSGD provides a fast and easy-to-use implementation of the SVM classifier using the Stochastic Gradient Descent approach, as presented in [bottou2010large].

The classifier has following parameters:

The model type may have one of the following values: SGD and ASGD.

The recommended model type is ASGD (following [bottou2010large]).

The margin type may have one of the following values: SOFT_MARGIN or HARD_MARGIN.

The other parameters may be described as follows:

Note that the parameters margin regularization, initial step size, and step decreasing power should be positive.

To use SVMSGD algorithm do as follows:

// Create empty object
// Train the Stochastic Gradient Descent SVM
svmsgd->train(trainData);
// Predict labels for the new samples
svmsgd->predict(samples, responses);

Member Enumeration Documentation

◆ MarginType

Margin type.

Enumerator
SOFT_MARGIN 

General case, suits to the case of non-linearly separable sets, allows outliers.

HARD_MARGIN 

More accurate for the case of linearly separable sets.

◆ SvmsgdType

SVMSGD type. ASGD is often the preferable choice.

Enumerator
SGD 

Stochastic Gradient Descent.

ASGD 

Average Stochastic Gradient Descent.

Member Function Documentation

◆ create()

static Ptr<SVMSGD> cv::ml::SVMSGD::create ( )
static

Creates empty model. Use StatModel::train to train the model. Since SVMSGD has several parameters, you may want to find the best parameters for your problem or use setOptimalParameters() to set some default parameters.

◆ getInitialStepSize()

virtual float cv::ml::SVMSGD::getInitialStepSize ( ) const
pure virtual

Parameter initialStepSize of a SVMSGD optimization problem.

See also
setInitialStepSize

◆ getMarginRegularization()

virtual float cv::ml::SVMSGD::getMarginRegularization ( ) const
pure virtual

Parameter marginRegularization of a SVMSGD optimization problem.

See also
setMarginRegularization

◆ getMarginType()

virtual int cv::ml::SVMSGD::getMarginType ( ) const
pure virtual

Margin type, one of SVMSGD::MarginType.

See also
setMarginType

◆ getShift()

virtual float cv::ml::SVMSGD::getShift ( )
pure virtual
Returns
the shift of the trained model (decision function f(x) = weights * x + shift).

◆ getStepDecreasingPower()

virtual float cv::ml::SVMSGD::getStepDecreasingPower ( ) const
pure virtual

Parameter stepDecreasingPower of a SVMSGD optimization problem.

See also
setStepDecreasingPower

◆ getSvmsgdType()

virtual int cv::ml::SVMSGD::getSvmsgdType ( ) const
pure virtual

Algorithm type, one of SVMSGD::SvmsgdType.

See also
setSvmsgdType

◆ getTermCriteria()

virtual TermCriteria cv::ml::SVMSGD::getTermCriteria ( ) const
pure virtual

Termination criteria of the training algorithm. You can specify the maximum number of iterations (maxCount) and/or how much the error could change between the iterations to make the algorithm continue (epsilon).

See also
setTermCriteria

◆ getWeights()

virtual Mat cv::ml::SVMSGD::getWeights ( )
pure virtual
Returns
the weights of the trained model (decision function f(x) = weights * x + shift).

◆ load()

static Ptr<SVMSGD> cv::ml::SVMSGD::load ( const String filepath,
const String nodeName = String() 
)
static

Loads and creates a serialized SVMSGD from a file.

Use SVMSGD::save to serialize and store an SVMSGD to disk. Load the SVMSGD from this file again, by calling this function with the path to the file. Optionally specify the node for the file containing the classifier

Parameters
filepathpath to serialized SVMSGD
nodeNamename of node containing the classifier

◆ setInitialStepSize()

virtual void cv::ml::SVMSGD::setInitialStepSize ( float  InitialStepSize)
pure virtual

Parameter initialStepSize of a SVMSGD optimization problem.

See also
getInitialStepSize

◆ setMarginRegularization()

virtual void cv::ml::SVMSGD::setMarginRegularization ( float  marginRegularization)
pure virtual

Parameter marginRegularization of a SVMSGD optimization problem.

See also
getMarginRegularization

◆ setMarginType()

virtual void cv::ml::SVMSGD::setMarginType ( int  marginType)
pure virtual

Margin type, one of SVMSGD::MarginType.

See also
getMarginType

◆ setOptimalParameters()

virtual void cv::ml::SVMSGD::setOptimalParameters ( int  svmsgdType = SVMSGD::ASGD,
int  marginType = SVMSGD::SOFT_MARGIN 
)
pure virtual

Function sets optimal parameters values for chosen SVM SGD model.

Parameters
svmsgdTypeis the type of SVMSGD classifier.
marginTypeis the type of margin constraint.

◆ setStepDecreasingPower()

virtual void cv::ml::SVMSGD::setStepDecreasingPower ( float  stepDecreasingPower)
pure virtual

Parameter stepDecreasingPower of a SVMSGD optimization problem.

See also
getStepDecreasingPower

◆ setSvmsgdType()

virtual void cv::ml::SVMSGD::setSvmsgdType ( int  svmsgdType)
pure virtual

Algorithm type, one of SVMSGD::SvmsgdType.

See also
getSvmsgdType

◆ setTermCriteria()

virtual void cv::ml::SVMSGD::setTermCriteria ( const cv::TermCriteria val)
pure virtual

Termination criteria of the training algorithm. You can specify the maximum number of iterations (maxCount) and/or how much the error could change between the iterations to make the algorithm continue (epsilon).

See also
getTermCriteria

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