nssTrainingRMSProp

RMSProp training options object for neural state-space systems

Since R2024b

Description

RMSProp options set object to train an idNeuralStateSpace network using nlssest.

Creation

Create an nssTrainingRMSProp object using nssTrainingOptions and specifying "rmsprop" as input argument.

Properties

UpdateMethod — Solver used to update network parameters

"RMSProp" (default)

Solver used to update network parameters, returned as a string. This property is read-only.

Use nssTrainingOptions("adam"), nssTrainingOptions("sgdm"), or nssTrainingOptions("lbfgs") to return an options set object for the Adam, SGDM, or L-BFGS solvers respectively. For more information on these algorithms, see the Algorithms section of trainingOptions (Deep Learning Toolbox).

SquaredGradientDecayFactor — Decay rate of squared gradient moving average

0.9 (default) | nonnegative scalar less than 1

Decay rate of squared gradient moving average for the RMSProp solver, specified as a nonnegative scalar less than 1.

Typical values of the decay rate are 0.9, 0.99, and 0.999, corresponding to averaging lengths of 10, 100, and 1000 parameter updates, respectively.

For more information, see Root Mean Square Propagation (Deep Learning Toolbox).

LossFcn — Type of function used to calculate loss

"MeanAbsoluteError" (default) | "MeanSquaredError"

Type of function used to calculate loss, specified as one of the following:

• "MeanAbsoluteError" — uses the mean value of the absolute error.

• "MeanSquaredError" — uses the mean value of the squared error.

PlotLossFcn — Option to plot the value of the loss function during training

true (default) | false

Option to plot the value of the loss function during training, specified as one of the following:

• true — plots the value of the loss function during training.

• false — does not plot the value of the loss function during training.

Lambda — Loss function regularization constant

0 (default) | positive scalar

Constant coefficient applied to the regularization term added to the loss function, specified as a positive scalar.

The loss function with the regularization term is given by:

${\widehat{V}}_N\left(\theta \right)=\frac{1}{N}{\displaystyle \sum _{t=1}^N{\epsilon }^2\left(t,\theta \right)+ \frac{1}{N}\lambda {\Vert \theta \Vert }^2}$

where t is the time variable, N is the size of the batch, ε is the sum of the reconstruction loss and autoencoder loss, θ is a concatenated vector of weights and biases of the neural network, and λ is the regularization constant that you can tune.

For more information, see Regularized Estimates of Model Parameters.

LearnRate — Learning rate

0.001 (default) | positive scalar

Learning rate used for training, specified as a positive scalar. If the learning rate is too small, then training can take a long time. If the learning rate is too large, then training might reach a suboptimal result or diverge.

LearnRateSchedule — Learning rate schedule

"none" (default) | character vector | string array | built-in or custom learning rate schedule object | function handle | cell array

Learning rate schedule, specified as a character vector or string scalar of a built-in learning rate schedule name, a string array of names, a built-in or custom learning rate schedule object, a function handle, or a cell array of names, metric objects, and function handles.

Example: "piecewise"

Built-In Learning Rate Schedule Names

Specify learning rate schedules as a string scalar, character vector, or a string or cell array of one or more of these names: "none", "piecewise", "warmup", "polynomial", "exponential", "cosine", or "cyclical".

For more information, see TrainingOptionsRMSProp (Deep Learning Toolbox).

LearnRateDropPeriod — Number of epochs for dropping the learning rate

10 (default) | positive integer

Number of epochs for dropping the learning rate, specified as a positive integer. This option is valid only when the LearnRateSchedule training option is "piecewise".

The software multiplies the global learning rate with the drop factor every time the specified number of epochs passes. Specify the drop factor using the LearnRateDropFactor training option.

LearnRateDropFactor — Factor for dropping the learning rate

0.1 (default) | scalar from 0 to 1

Factor for dropping the learning rate, specified as a scalar from 0 to 1. This option is valid only when the LearnRateSchedule training option is "piecewise".

LearnRateDropFactor is a multiplicative factor to apply to the learning rate every time a certain number of epochs passes. Specify the number of epochs using the LearnRateDropPeriod training option.

MaxEpochs — Maximum number of epochs

100 (default) | positive integer

Maximum number of epochs to use for training, specified as a positive integer. An epoch is the full pass of the training algorithm over the entire training set.

MiniBatchSize — Size of mini-batch

1000 (default) | positive integer

Size of the mini-batch to use for each training iteration, specified as a positive integer. A mini-batch is a subset of the training set that is used to evaluate the gradient of the loss function and update the weights.

If the mini-batch size does not evenly divide the number of training samples, then nlssest discards the training data that does not fit into the final complete mini-batch of each epoch.

Beta — Coefficient applied to tune the reconstruction loss of an autoencoder

0 (default) | nonnegative scalar

Coefficient applied to tune the reconstruction loss of an autoencoder, specified as a nonnegative scalar.

Reconstruction loss measures the difference between the original input (x) and its reconstruction (xr) after encoding and decoding. You calculate this loss as the L2 norm of (x - xr) divided by the batch size (N).

WindowSize — Size of data frames

intmax (default) | positive integer

Number of samples in each frame or batch when segmenting data for model training, specified as a positive integer.

Overlap — Size of overlap

"auto" (default) | integer

Number of samples in the overlap between successive frames when segmenting data for model training, specified as an integer. A negative integer indicates that certain data samples are skipped when creating the data frames.

The default value, "auto", implies that the size of the overlap is 0.

ODESolverOptions — ODE solver options for continuous-time systems

nssDLODE45 (default)

ODE solver options to integrate continuous-time neural state-space systems, specified as an nssDLODE45 object.

Use dot notation to access properties such as the following:

• Solver — Solver type, set as "dlode45". This is a read-only property.

• InitialStepSize — Initial step size, specified as a positive scalar. If you do not specify an initial step size, then the solver bases the initial step size on the slope of the solution at the initial time point.

• MaxStepSize — Maximum step size, specified as a positive scalar. It is an upper bound on the size of any step taken by the solver. The default is one tenth of the difference between final and initial time.

• AbsoluteTolerance — Absolute tolerance, specified as a positive scalar. It is the largest allowable absolute error. Intuitively, when the solution approaches 0, AbsoluteTolerance is the threshold below which you do not worry about the accuracy of the solution since it is effectively 0.

• RelativeTolerance — Relative tolerance, specified as a positive scalar. This tolerance measures the error relative to the magnitude of each solution component. Intuitively, it controls the number of significant digits in a solution, (except when it is smaller than the absolute tolerance).

For more information, see odeset.

InputInterSample — Input interpolation method

'foh' (default) | 'zoh' | 'spline' | 'cubic' | 'makima' | 'pchip'

Input interpolation method, specified as one of the following:

• 'zoh' — uses zero-order hold interpolation method.

• 'foh' — uses first-order hold interpolation method.

• 'cubic' — uses cubic interpolation method.

• 'makima' — uses modified Akima interpolation method.

• 'pchip' — uses shape-preserving piecewise cubic interpolation method.

• 'spline' — uses spline interpolation method.

This is the interpolation method used to interpolate the input when integrating continuous-time neural state-space systems. For more information, see interpolation methods in interp1.

Object Functions

Examples

Create RMSProp Option Set to Train a Neural State-Space System

Use nssTrainingOptions to return an options set object to train an idNeuralStateSpace system.

rmspropOpts = nssTrainingOptions("rmsprop")

rmspropOpts = 
  nssTrainingRMSProp with properties:

                  UpdateMethod: "RMSProp"
                     LearnRate: 1.0000e-03
    SquaredGradientDecayFactor: 0.9000
                     MaxEpochs: 100
                 MiniBatchSize: 1000
             LearnRateSchedule: "none"
           LearnRateDropFactor: 0.1000
           LearnRateDropPeriod: 10
                        Lambda: 0
                          Beta: 0
                       LossFcn: "MeanAbsoluteError"
                   PlotLossFcn: 1
              ODESolverOptions: [1×1 idoptions.nssDLODE45]
              InputInterSample: 'foh'
                    WindowSize: 2.1475e+09
                       Overlap: "auto"

Use dot notation to access the object properties.

rmspropOpts.PlotLossFcn = false;

You can use rmspropOpts as an input argument to nlssest to specify the training options for the state or the non-trivial output network of an idNeuralStateSpace object.

Version History

Introduced in R2024b