org.apache.ignite.ml.regressions.logistic.binomial

Class LogisticRegressionSGDTrainer<P extends Serializable>

java.lang.Object

org.apache.ignite.ml.trainers.DatasetTrainer<M,Double>

org.apache.ignite.ml.trainers.SingleLabelDatasetTrainer<LogisticRegressionModel>

org.apache.ignite.ml.regressions.logistic.binomial.LogisticRegressionSGDTrainer<P>

public class LogisticRegressionSGDTrainer<P extends Serializable>
extends SingleLabelDatasetTrainer<LogisticRegressionModel>

Trainer of the logistic regression model based on stochastic gradient descent algorithm.

Nested Class Summary

Nested classes/interfaces inherited from class org.apache.ignite.ml.trainers.DatasetTrainer

DatasetTrainer.EmptyDatasetException

Field Summary

Fields inherited from class org.apache.ignite.ml.trainers.DatasetTrainer

environment

Constructor Summary

Constructors

Constructor and Description
LogisticRegressionSGDTrainer()

Method Summary

Modifier and Type	Method and Description
protected boolean	checkState(LogisticRegressionModel mdl)
<K,V> LogisticRegressionModel	fit(DatasetBuilder<K,V> datasetBuilder, IgniteBiFunction<K,V,Vector> featureExtractor, IgniteBiFunction<K,V,Double> lbExtractor) Trains model based on the specified data.
int	getBatchSize() Get the batch size.
int	getLocIterations() Get the amount of local iterations.
int	getMaxIterations() Get the max amount of iterations.
long	getSeed() Get the seed for random generator.
UpdatesStrategy	getUpdatesStgy() Get the update strategy.
protected <K,V> LogisticRegressionModel	updateModel(LogisticRegressionModel mdl, DatasetBuilder<K,V> datasetBuilder, IgniteBiFunction<K,V,Vector> featureExtractor, IgniteBiFunction<K,V,Double> lbExtractor) Gets state of model in arguments, update in according to new data and return new model.
LogisticRegressionSGDTrainer<P>	withBatchSize(int batchSize) Set up the batchSize parameter.
LogisticRegressionSGDTrainer<P>	withLocIterations(int amountOfLocIterations) Set up the amount of local iterations of SGD algorithm.
LogisticRegressionSGDTrainer<P>	withMaxIterations(int maxIterations) Set up the max amount of iterations before convergence.
LogisticRegressionSGDTrainer<P>	withSeed(long seed) Set up the random seed parameter.
LogisticRegressionSGDTrainer	withUpdatesStgy(UpdatesStrategy updatesStgy) Set up the regularization parameter.

Methods inherited from class org.apache.ignite.ml.trainers.DatasetTrainer

fit, fit, fit, fit, getLastTrainedModelOrThrowEmptyDatasetException, setEnvironment, update, update, update, update, update

Methods inherited from class java.lang.Object

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

Constructor Detail

LogisticRegressionSGDTrainer

public LogisticRegressionSGDTrainer()

Method Detail

fit

public <K,V> LogisticRegressionModel fit(DatasetBuilder<K,V> datasetBuilder,
                                         IgniteBiFunction<K,V,Vector> featureExtractor,
                                         IgniteBiFunction<K,V,Double> lbExtractor)

Trains model based on the specified data.

Specified by:

fit in class DatasetTrainer<LogisticRegressionModel,Double>

Type Parameters:

K - Type of a key in upstream data.

V - Type of a value in upstream data.

Parameters:

datasetBuilder - Dataset builder.

featureExtractor - Feature extractor.

lbExtractor - Label extractor.

Returns:

Model.

updateModel

protected <K,V> LogisticRegressionModel updateModel(LogisticRegressionModel mdl,
                                                    DatasetBuilder<K,V> datasetBuilder,
                                                    IgniteBiFunction<K,V,Vector> featureExtractor,
                                                    IgniteBiFunction<K,V,Double> lbExtractor)

Gets state of model in arguments, update in according to new data and return new model.

Specified by:

updateModel in class DatasetTrainer<LogisticRegressionModel,Double>

Type Parameters:

K - Type of a key in upstream data.

V - Type of a value in upstream data.

Parameters:

mdl - Learned model.

datasetBuilder - Dataset builder.

featureExtractor - Feature extractor.

lbExtractor - Label extractor.

Returns:

Updated model.

checkState

protected boolean checkState(LogisticRegressionModel mdl)

Specified by:

checkState in class DatasetTrainer<LogisticRegressionModel,Double>

Parameters:

mdl - Model.

Returns:

true if current critical for training parameters correspond to parameters from last training.

withMaxIterations

public LogisticRegressionSGDTrainer<P> withMaxIterations(int maxIterations)

Set up the max amount of iterations before convergence.

Parameters:

maxIterations - The parameter value.

Returns:

Model with new max number of iterations before convergence parameter value.

withBatchSize

public LogisticRegressionSGDTrainer<P> withBatchSize(int batchSize)

Set up the batchSize parameter.

Parameters:

batchSize - The size of learning batch.

Returns:

Trainer with new batch size parameter value.

withLocIterations

public LogisticRegressionSGDTrainer<P> withLocIterations(int amountOfLocIterations)

Set up the amount of local iterations of SGD algorithm.

Parameters:

amountOfLocIterations - The parameter value.

Returns:

Trainer with new locIterations parameter value.

withSeed

public LogisticRegressionSGDTrainer<P> withSeed(long seed)

Set up the random seed parameter.

Parameters:

seed - Seed for random generator.

Returns:

Trainer with new seed parameter value.

withUpdatesStgy

public LogisticRegressionSGDTrainer withUpdatesStgy(UpdatesStrategy updatesStgy)

Set up the regularization parameter.

Parameters:

updatesStgy - Update strategy.

Returns:

Trainer with new update strategy parameter value.

getUpdatesStgy

public UpdatesStrategy getUpdatesStgy()

Get the update strategy.

Returns:

The property value.

getMaxIterations

public int getMaxIterations()

Get the max amount of iterations.

Returns:

The property value.

getBatchSize

public int getBatchSize()

Get the batch size.

Returns:

The property value.

getLocIterations

public int getLocIterations()

Get the amount of local iterations.

Returns:

The property value.

getSeed

public long getSeed()

Get the seed for random generator.

Returns:

The property value.