org.encog.neural.networks.training.propagation.resilient
Class ResilientPropagation

java.lang.Object
  org.encog.neural.networks.training.BasicTraining
      org.encog.neural.networks.training.propagation.Propagation
          org.encog.neural.networks.training.propagation.resilient.ResilientPropagation

All Implemented Interfaces:

Train

public class ResilientPropagation
extends Propagation

One problem with the backpropagation algorithm is that the magnitude of the partial derivative is usually too large or too small. Further, the learning rate is a single value for the entire neural network. The resilient propagation learning algorithm uses a special update value(similar to the learning rate) for every neuron connection. Further these update values are automatically determined, unlike the learning rate of the backpropagation algorithm. For most training situations, we suggest that the resilient propagation algorithm (this class) be used for training. There are a total of three parameters that must be provided to the resilient training algorithm. Defaults are provided for each, and in nearly all cases, these defaults are acceptable. This makes the resilient propagation algorithm one of the easiest and most efficient training algorithms available. The optional parameters are: zeroTolerance - How close to zero can a number be to be considered zero. The default is 0.00000000000000001. initialUpdate - What are the initial update values for each matrix value. The default is 0.1. maxStep - What is the largest amount that the update values can step. The default is 50. Usually you will not need to use these, and you should use the constructor that does not require them.

Author:

jheaton

Field Summary

static String	LAST_GRADIENTS Continuation tag for the last gradients.
static String	UPDATE_VALUES Continuation tag for the last values.

Constructor Summary

ResilientPropagation(BasicNetwork network, NeuralDataSet training)
Construct a resilient training object.

ResilientPropagation(BasicNetwork network, NeuralDataSet training, OpenCLTrainingProfile profile)
Construct an RPROP trainer, allows an OpenCL device to be specified.

ResilientPropagation(BasicNetwork network, NeuralDataSet training, OpenCLTrainingProfile profile, double initialUpdate, double maxStep)
Construct a resilient training object, allow the training parameters to be specified.

Method Summary

boolean	canContinue()
boolean	isValidResume(TrainingContinuation state) Determine if the specified continuation object is valid to resume with.
TrainingContinuation	pause() Pause the training.
void	resume(TrainingContinuation state) Resume training.

Methods inherited from class org.encog.neural.networks.training.propagation.Propagation

finishTraining, getCurrentFlatNetwork, getFlatTraining, getNetwork, getNumThreads, getProfile, iteration, iteration, setFlatTraining, setNumThreads

Methods inherited from class org.encog.neural.networks.training.BasicTraining

addStrategy, getCloud, getError, getIteration, getStrategies, getTraining, isTrainingDone, postIteration, preIteration, setCloud, setError, setIteration, setTraining

Methods inherited from class java.lang.Object

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

Field Detail

LAST_GRADIENTS

public static final String LAST_GRADIENTS

Continuation tag for the last gradients.

See Also:

Constant Field Values

UPDATE_VALUES

public static final String UPDATE_VALUES

Continuation tag for the last values.

See Also:

Constant Field Values

Constructor Detail

ResilientPropagation

public ResilientPropagation(BasicNetwork network,
                            NeuralDataSet training)

Construct a resilient training object. Use the defaults for all training parameters. Usually this is the constructor to use as the resilient training algorithm is designed for the default parameters to be acceptable for nearly all problems. Use the CPU to train.

Parameters:

network - The network to train.

training - The training set to use.

ResilientPropagation

public ResilientPropagation(BasicNetwork network,
                            NeuralDataSet training,
                            OpenCLTrainingProfile profile)

Construct an RPROP trainer, allows an OpenCL device to be specified. Use the defaults for all training parameters. Usually this is the constructor to use as the resilient training algorithm is designed for the default parameters to be acceptable for nearly all problems.

Parameters:

network - The network to train.

training - The training data to use.

profile - The profile to use.

ResilientPropagation

public ResilientPropagation(BasicNetwork network,
                            NeuralDataSet training,
                            OpenCLTrainingProfile profile,
                            double initialUpdate,
                            double maxStep)

Construct a resilient training object, allow the training parameters to be specified. Usually the default parameters are acceptable for the resilient training algorithm. Therefore you should usually use the other constructor, that makes use of the default values.

Parameters:

network - The network to train.

training - The training set to use.

profile - Optional EncogCL profile to execute on.

initialUpdate - The initial update values, this is the amount that the deltas are all initially set to.

maxStep - The maximum that a delta can reach.

Method Detail

canContinue

public boolean canContinue()

Overrides:

canContinue in class Propagation

Returns:

True, as RPROP can continue.

isValidResume

public boolean isValidResume(TrainingContinuation state)

Determine if the specified continuation object is valid to resume with.

Overrides:

isValidResume in class Propagation

Parameters:

state - The continuation object to check.

Returns:

True if the specified continuation object is valid for this training method and network.

pause

public TrainingContinuation pause()

Pause the training.

Overrides:

pause in class Propagation

Returns:

A training continuation object to continue with.

resume

public void resume(TrainingContinuation state)

Resume training.

Overrides:

resume in class Propagation

Parameters:

state - The training state to return to.