bounds

Minimum and maximum signal data values

Since R2026a

collapse all in page

    Syntax

    [sigMin,sigMax] = bounds(sigObj)
    [sigMin,sigMax] = bounds(sigObj,startTime)
    [sigMin,sigMax] = bounds(sigObj,startTime,endTime)

    Description

    [sigMin,sigMax] = bounds(sigObj) returns the minimum data value sigMin and maximum data value sigMax in the Simulink.sdi.Signal object sigObj at the end of simulation.

    example

    [sigMin,sigMax] = bounds(sigObj,startTime) returns the minimum and maximum in the time interval between startTime and the end of simulation.

    [sigMin,sigMax] = bounds(sigObj,startTime,endTime) returns the minimum and maximum 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 minimum and maximum sample values using the bounds function.

    [minVal,maxVal] = bounds(sigObj)
    minVal =

   -2.4828


maxVal =

    2.0185

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

    [minValEnd,maxValEnd] = bounds(sigObj,8)
    minValEnd =

   -2.4828


maxValEnd =

    1.7524

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

    [minValInterval,maxValInterval] = bounds(sigObj,2,4)
    minValInterval =

   -2.3775


maxValInterval =

    1.6065

    Input Arguments

    collapse all

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

    To find the bounds of a composite signal element, such as a bus element, or the bounds 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: [minVal,maxVal] = bounds(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 minimum and maximum values.

    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 minimum and maximum values.

    Output Arguments

    collapse all

    Minimum value, returned as a scalar.

    Maximum value, returned as a scalar.

    Version History

    Introduced in R2026a

    See Also

    Tools

    Blocks

    Objects

    Functions

    Topics