std

Standard deviation of signal data values

Since R2026a

collapse all in page

    Syntax

    sigStd = std(sigObj)
    sigStd = std(sigObj,startTime)
    sigStd = std(sigObj,startTime,endTime)

    Description

    sigStd = std(sigObj) returns the standard deviation of the data values in the Simulink.sdi.Signal object sigObj.

    example

    sigStd = std(sigObj,startTime) returns the standard deviation of the data values in the time interval between startTime and the end of simulation.

    sigStd = std(sigObj,startTime,endTime) returns the standard deviation of the data values in the time interval specified by startTime and endTime, inclusive.

    Examples

    collapse all

    Suppose you log a signal generated from a Random Number block to the Simulation Data Inspector. You can get descriptive statics about the logged signal using the Simulink.sdi.Signal object.

    A signal generated from a Random Number block plotted on a time plot in the Simulation Data Inspector.

    Access the Simulink.sdi.Signal object for the signal named mySig.

    runObj = Simulink.sdi.Run.getLatest;
sigObj = getSignalsByName(runObj,"mySig");

    Find the standard deviation of sample values using the std function.

    stdVal = std(sigObj)
    stdVal =

    0.0708

    To find the standard deviation of sample values near the end of the simulation, specify the starting time. For example, to find the standard deviation of sample values in the last two seconds of the simulation, specify startTime as 8.

    stdValEnd = std(sigObj,8)
    stdVal =

    0.1382

    To find the standard deviation of sample values in a specific interval, specify the start and end time to search in. For example, find the standard deviation of sample values between 2 seconds and 4 seconds.

    stdValInterval = std(sigObj,2,4)
    stdValInterval =

    0.0684

    Input Arguments

    collapse all

    Input signal, specified as a numerical scalar Simulink.sdi.Signal object.

    To find the standard deviation in values of a composite signal element, such as a bus element, or the standard deviation in values of the real or imaginary part of a complex signal, use the Children property. The Children property contains Simulink.sdi.Signal objects that make up the composite signal or real and imaginary parts of the complex signal.

    • For composite signals, access elements in the Children property by index.

    • For complex signals, the first element in the Children property is the real part of the complex signal and the second element is the imaginary part.

    Example: stdVal = std(complexSig.Children(1))

    Start time, specified as a nonnegative scalar less than endTime. This time specifies the beginning of the time interval in which to find the standard deviation.

    End time, specified as a nonnegative scalar greater than startTime and less than the simulation time. This time specifies the end of the time interval in which to find the standard deviation.

    Output Arguments

    collapse all

    Standard deviation, returned as a scalar.

    Version History

    Introduced in R2026a

    See Also

    Tools

    Blocks

    Objects

    Functions

    Topics