Main Content

SignalStatisticsConfiguration

Compute and display signal statistics

Since R2022a

    Description

    Use the SignalStatisticsConfiguration object to measure signal statistics such as maximum, minimum, peak-to-peak value, mean, variance, standard deviation, median, RMS, and mean square.

    You can enable the scope to compute and display signal statistics from the toolstrip or from the command line. To enable from the scope interface, click the Measurements tab, and then click Signal Statistics. A statistics panel appears at the bottom of the scope window. To enable specific statistics, click the Signal Statistics drop-down list and select a statistic from the options. The Statistics panel shows those statistics.

    Time Scope

    Time Scope window with all the enabled signal statistics.

    Creation

    Description

    signalStats = SignalStatisticsConfiguration() creates a signal statistics configuration object signalStats.

    example

    Properties

    expand all

    All properties are tunable.

    Compute and display the maximum value, specified as true or false. The scope computes and displays the maximum value of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Max.

    Data Types: logical

    Compute and display the minimum value, specified as true or false. The scope computes and displays the minimum value of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Min.

    Data Types: logical

    Compute and display the peak-to-peak values, specified as true or false. The scope computes and displays the peak-to-peak values from the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Peak to Peak.

    Data Types: logical

    Compute and display the mean value, specified as true or false. The scope computes and displays the mean value of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Mean.

    Data Types: logical

    Compute and display the variance, specified as true or false. The scope computes and displays the variance of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Variance.

    Data Types: logical

    Compute and display the standard deviation, specified as true or false. The scope computes and displays the standard deviation of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Standard Deviation.

    Data Types: logical

    Compute and display the median, specified as true or false. The scope computes and displays the median of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Median.

    Data Types: logical

    Compute and display the RMS, specified as true or false. The scope computes and displays the RMS of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select RMS.

    Data Types: logical

    Compute and display the mean square, specified as true or false. The scope computes and displays the mean square of the portion of the input signal that is currently on display in the scope.

    Scope Window Use

    On the Measurements tab, select Signal Statistics and then click Signal Statistics to select Mean Square.

    Data Types: logical

    Enable signal statistics measurements, specified as true or false. Set this property to true to enable signal statistics measurements.

    Scope Window Use

    On the Measurements tab, select Signal Statistics(Icon of signal statistics).

    Data Types: logical

    Examples

    collapse all

    Create a sine wave and view it in the Time Scope. Enable the scope programmatically to compute the signal statistics.

    The object supports these signal statistics:

    • Maximum

    • Minimum

    • Mean

    • Median

    • RMS

    • Peak to peak

    • Variance

    • Standard deviation

    • Mean square

    Initialization

    Create the input sine wave using the sin function. Create a timescope MATLAB® object to display the signal. Set the TimeSpan property to 1 second.

    f = 100;
    fs = 1000;
    swv = sin(2.*pi.*f.*(0:1/fs:1-1/fs)).';
    scope = timescope(SampleRate=fs,...
        TimeSpanSource="property",...
        TimeSpan=1);

    Signal Statistics

    Enable the scope to show signal statistics programmatically by setting the SignalStatistics > Enabled property to true.

    scope.SignalStatistics.Enabled = true;

    By default, the scope enables the following measurements.

    scope.SignalStatistics
    ans = 
      SignalStatisticsConfiguration with properties:
    
                      ShowMax: 1
                      ShowMin: 1
               ShowPeakToPeak: 1
                     ShowMean: 1
                 ShowVariance: 0
        ShowStandardDeviation: 1
                   ShowMedian: 1
                      ShowRMS: 1
               ShowMeanSquare: 0
                      Enabled: 1
    
    

    Display the sine wave in the scope. A Statistics pane appears at the bottom of the scope window displaying the statistics for the portion of the signal that you can see in the scope.

    If you use the zoom options on the scope, the statistics automatically adjust to the time range in the display.

    scope(swv);
    release(scope);

    Version History

    Introduced in R2022a