org.apache.spark.mllib.classification

Class SVMWithSGD

java.lang.Object

org.apache.spark.mllib.regression.GeneralizedLinearAlgorithm<SVMModel>

org.apache.spark.mllib.classification.SVMWithSGD

All Implemented Interfaces:

java.io.Serializable, Logging

public class SVMWithSGD
extends GeneralizedLinearAlgorithm<SVMModel>
implements scala.Serializable

Train a Support Vector Machine (SVM) using Stochastic Gradient Descent. By default L2 regularization is used, which can be changed via SVMWithSGD.optimizer. NOTE: Labels used in SVM should be {0, 1}.

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
SVMWithSGD() Construct a SVM object with default parameters: {stepSize: 1.0, numIterations: 100, regParm: 0.01, miniBatchFraction: 1.0}.

Method Summary

Methods

Modifier and Type	Method and Description
protected SVMModel	createModel(Vector weights, double intercept) Create a model given the weights and intercept
GradientDescent	optimizer() The optimizer to solve the problem.
static SVMModel	train(RDD<LabeledPoint> input, int numIterations) Train a SVM model given an RDD of (label, features) pairs.
static SVMModel	train(RDD<LabeledPoint> input, int numIterations, double stepSize, double regParam) Train a SVM model given an RDD of (label, features) pairs.
static SVMModel	train(RDD<LabeledPoint> input, int numIterations, double stepSize, double regParam, double miniBatchFraction) Train a SVM model given an RDD of (label, features) pairs.
static SVMModel	train(RDD<LabeledPoint> input, int numIterations, double stepSize, double regParam, double miniBatchFraction, Vector initialWeights) Train a SVM model given an RDD of (label, features) pairs.
protected scala.collection.immutable.List<scala.Function1<RDD<LabeledPoint>,java.lang.Object>>	validators()

Methods inherited from class org.apache.spark.mllib.regression.GeneralizedLinearAlgorithm

addIntercept, getNumFeatures, isAddIntercept, numFeatures, numOfLinearPredictor, run, run, setIntercept, setValidateData, validateData

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.apache.spark.Logging

initializeIfNecessary, initializeLogging, isTraceEnabled, log_, log, logDebug, logDebug, logError, logError, logInfo, logInfo, logName, logTrace, logTrace, logWarning, logWarning

Constructor Detail

SVMWithSGD

public SVMWithSGD()

Construct a SVM object with default parameters: {stepSize: 1.0, numIterations: 100, regParm: 0.01, miniBatchFraction: 1.0}.

Method Detail

train

public static SVMModel train(RDD<LabeledPoint> input,
             int numIterations,
             double stepSize,
             double regParam,
             double miniBatchFraction,
             Vector initialWeights)

Train a SVM model given an RDD of (label, features) pairs. We run a fixed number of iterations of gradient descent using the specified step size. Each iteration uses miniBatchFraction fraction of the data to calculate the gradient. The weights used in gradient descent are initialized using the initial weights provided.

NOTE: Labels used in SVM should be {0, 1}.

Parameters:

input - RDD of (label, array of features) pairs.

numIterations - Number of iterations of gradient descent to run.

stepSize - Step size to be used for each iteration of gradient descent.

regParam - Regularization parameter.

miniBatchFraction - Fraction of data to be used per iteration.

initialWeights - Initial set of weights to be used. Array should be equal in size to the number of features in the data.

Returns:

(undocumented)

train

public static SVMModel train(RDD<LabeledPoint> input,
             int numIterations,
             double stepSize,
             double regParam,
             double miniBatchFraction)

Train a SVM model given an RDD of (label, features) pairs. We run a fixed number of iterations of gradient descent using the specified step size. Each iteration uses miniBatchFraction fraction of the data to calculate the gradient. NOTE: Labels used in SVM should be {0, 1}

Parameters:

input - RDD of (label, array of features) pairs.

numIterations - Number of iterations of gradient descent to run.

stepSize - Step size to be used for each iteration of gradient descent.

regParam - Regularization parameter.

miniBatchFraction - Fraction of data to be used per iteration.

Returns:

(undocumented)

train

public static SVMModel train(RDD<LabeledPoint> input,
             int numIterations,
             double stepSize,
             double regParam)

Train a SVM model given an RDD of (label, features) pairs. We run a fixed number of iterations of gradient descent using the specified step size. We use the entire data set to update the gradient in each iteration. NOTE: Labels used in SVM should be {0, 1}

Parameters:

input - RDD of (label, array of features) pairs.

stepSize - Step size to be used for each iteration of Gradient Descent.

regParam - Regularization parameter.

numIterations - Number of iterations of gradient descent to run.

Returns:

a SVMModel which has the weights and offset from training.

train

public static SVMModel train(RDD<LabeledPoint> input,
             int numIterations)

Train a SVM model given an RDD of (label, features) pairs. We run a fixed number of iterations of gradient descent using a step size of 1.0. We use the entire data set to update the gradient in each iteration. NOTE: Labels used in SVM should be {0, 1}

Parameters:

input - RDD of (label, array of features) pairs.

numIterations - Number of iterations of gradient descent to run.

Returns:

a SVMModel which has the weights and offset from training.

optimizer

public GradientDescent optimizer()

Description copied from class: GeneralizedLinearAlgorithm

The optimizer to solve the problem.

Specified by:

optimizer in class GeneralizedLinearAlgorithm<SVMModel>

Returns:

(undocumented)

validators

protected scala.collection.immutable.List<scala.Function1<RDD<LabeledPoint>,java.lang.Object>> validators()

Overrides:

validators in class GeneralizedLinearAlgorithm<SVMModel>

createModel

protected SVMModel createModel(Vector weights,
                   double intercept)

Description copied from class: GeneralizedLinearAlgorithm

Create a model given the weights and intercept

Specified by:

createModel in class GeneralizedLinearAlgorithm<SVMModel>

Parameters:

weights - (undocumented)

intercept - (undocumented)

Returns:

(undocumented)