Main Content

updateInfo

Update information columns in experiment results table

    Description

    updateInfo(monitor,infoName=value) updates the specified information column for a trial in the Experiment Manager results table.

    example

    updateInfo(monitor,infoName1=value1,...,infoNameN=valueN) updates multiple information columns for a trial.

    example

    updateInfo(monitor,structure) updates the information columns using the values specified by the structure structure.

    Examples

    collapse all

    Use an experiments.Monitor object to track the progress of the training, display information and metric values in the experiment results table, and produce training plots for custom training experiments.

    Before starting the training, specify the names of the information and metric columns of the Experiment Manager results table.

    monitor.Info = ["GradientDecayFactor","SquaredGradientDecayFactor"];
    monitor.Metrics = ["TrainingLoss","ValidationLoss"];

    Specify the horizontal axis label for the training plot. Group the training and validation loss in the same subplot.

    monitor.XLabel = "Iteration";
    groupSubPlot(monitor,"Loss",["TrainingLoss","ValidationLoss"]);

    Update the values of the gradient decay factor and the squared gradient decay factor for the trial in the results table.

    updateInfo(monitor, ...
        GradientDecayFactor=gradientDecayFactor, ...
        SquaredGradientDecayFactor=squaredGradientDecayFactor);

    After each iteration of the custom training loop, record the value of training and validation loss for the trial in the results table and the training plot.

    recordMetrics(monitor,iteration, ...
        TrainingLoss=trainingLoss, ...
        ValidationLoss=validationLoss);

    Update the training progress for the trial based on the fraction of iterations completed.

    monitor.Progress = (iteration/numIterations) * 100;

    Use a structure to update values of information columns in the results table.

    structure.GradientDecayFactor = gradientDecayFactor;
    structure.SquaredGradientDecayFactor = squaredGradientDecayFactor;
    updateInfo(monitor,structure);

    Input Arguments

    collapse all

    Experiment monitor for the trial, specified as an experiments.Monitor object. When you run a custom training experiment, Experiment Manager passes this object as the second input argument of the training function.

    Information column name, specified as a string or character vector. This name must be an element of the Info property of the experiments.Monitor object monitor.

    Data Types: char | string

    Information column value, specified as a numeric scalar, string, or character vector.

    Data Types: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | char | string

    Information column names and values, specified as a structure. Names must be elements of the Info property of the experiments.Monitor object monitor and can appear in any order in the structure.

    Example: struct(GradientDecayFactor=gradientDecayFactor,SquaredGradientDecayFactor=squaredGradientDecayFactor)

    Data Types: struct

    Tips

    • Both information and metric columns display values in the results table for your experiment. Additionally, the training plot shows a record of the metric values. Use information columns for text and for numerical values that you want to display in the results table but not in the training plot.

    Introduced in R2021a