org.apache.spark.mllib.regression

Class StreamingLinearRegressionWithSGD

java.lang.Object

org.apache.spark.mllib.regression.StreamingLinearAlgorithm<LinearRegressionModel,LinearRegressionWithSGD>

org.apache.spark.mllib.regression.StreamingLinearRegressionWithSGD

All Implemented Interfaces:

java.io.Serializable, Logging

public class StreamingLinearRegressionWithSGD
extends StreamingLinearAlgorithm<LinearRegressionModel,LinearRegressionWithSGD>
implements scala.Serializable

:: Experimental :: Train or predict a linear regression model on streaming data. Training uses Stochastic Gradient Descent to update the model based on each new batch of incoming data from a DStream (see LinearRegressionWithSGD for model equation)

Each batch of data is assumed to be an RDD of LabeledPoints. The number of data points per batch can vary, but the number of features must be constant. An initial weight vector must be provided.

Use a builder pattern to construct a streaming linear regression analysis in an application, like:

val model = new StreamingLinearRegressionWithSGD() .setStepSize(0.5) .setNumIterations(10) .setInitialWeights(Vectors.dense(...)) .trainOn(DStream)

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
StreamingLinearRegressionWithSGD() Construct a StreamingLinearRegression object with default parameters: {stepSize: 0.1, numIterations: 50, miniBatchFraction: 1.0}.

Method Summary

Methods

Modifier and Type	Method and Description
LinearRegressionWithSGD	algorithm() The algorithm to use for updating.
protected scala.Option<LinearRegressionModel>	model() The model to be updated and used for prediction.
StreamingLinearRegressionWithSGD	setConvergenceTol(double tolerance) Set the convergence tolerance.
StreamingLinearRegressionWithSGD	setInitialWeights(Vector initialWeights) Set the initial weights.
StreamingLinearRegressionWithSGD	setMiniBatchFraction(double miniBatchFraction) Set the fraction of each batch to use for updates.
StreamingLinearRegressionWithSGD	setNumIterations(int numIterations) Set the number of iterations of gradient descent to run per update.
StreamingLinearRegressionWithSGD	setStepSize(double stepSize) Set the step size for gradient descent.

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

latestModel, predictOn, predictOn, predictOnValues, predictOnValues, trainOn, trainOn

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

StreamingLinearRegressionWithSGD

public StreamingLinearRegressionWithSGD()

Construct a StreamingLinearRegression object with default parameters: {stepSize: 0.1, numIterations: 50, miniBatchFraction: 1.0}. Initial weights must be set before using trainOn or predictOn (see StreamingLinearAlgorithm)

Method Detail

algorithm

public LinearRegressionWithSGD algorithm()

Description copied from class: StreamingLinearAlgorithm

The algorithm to use for updating.

Specified by:

algorithm in class StreamingLinearAlgorithm<LinearRegressionModel,LinearRegressionWithSGD>

model

protected scala.Option<LinearRegressionModel> model()

Description copied from class: StreamingLinearAlgorithm

The model to be updated and used for prediction.

Specified by:

model in class StreamingLinearAlgorithm<LinearRegressionModel,LinearRegressionWithSGD>

setStepSize

public StreamingLinearRegressionWithSGD setStepSize(double stepSize)

Set the step size for gradient descent. Default: 0.1.

Parameters:

stepSize - (undocumented)

Returns:

(undocumented)

setNumIterations

public StreamingLinearRegressionWithSGD setNumIterations(int numIterations)

Set the number of iterations of gradient descent to run per update. Default: 50.

Parameters:

numIterations - (undocumented)

Returns:

(undocumented)

setMiniBatchFraction

public StreamingLinearRegressionWithSGD setMiniBatchFraction(double miniBatchFraction)

Set the fraction of each batch to use for updates. Default: 1.0.

Parameters:

miniBatchFraction - (undocumented)

Returns:

(undocumented)

setInitialWeights

public StreamingLinearRegressionWithSGD setInitialWeights(Vector initialWeights)

Set the initial weights.

Parameters:

initialWeights - (undocumented)

Returns:

(undocumented)

setConvergenceTol

public StreamingLinearRegressionWithSGD setConvergenceTol(double tolerance)

Set the convergence tolerance. Default: 0.001.

Parameters:

tolerance - (undocumented)

Returns:

(undocumented)