Main Content

probability

Use CCDF to find probability for specified relative power

Since R2022a

collapse all in page

    Syntax

    prob = probability(meter,relpower)

    Description

    prob = probability(meter,relpower) finds the probability prob in percent that the instantaneous signal power is above the average signal power by relpower dB.

    example

    Examples

    collapse all

    Open Live Script

    Compute the average power measurement of the generated voltage signal.

    x = complex(rand(10000,1)-0.5,rand(10000,1)-0.5);
pm = powermeter(ComputeCCDF=true);
averagePower = pm(x);                             % power in dB

    Compute the probability that the instantaneous power of the signal is 3 dB above the average power.

    prob = probability(pm,3) % probability in percentage
    prob = 
7.6009

    Plot the CCDF curve.

    plotCCDF(pm,GaussianReference=true)

    Figure contains an axes object. The axes object with title CCDF Measurement, xlabel Relative power (dB above average power), ylabel Probability (%) contains 2 objects of type line. These objects represent CCDF 1, Gaussian reference.

    Find the relative power for the given probability.

    relativepwr = relativePower(pm,prob)
    relativepwr = 
3.0000

    Input Arguments

    collapse all

    Power meter, specified as a powermeter System object™.

    Relative power in dB, specified as a column vector.

    Data Types: single | double

    Output Arguments

    collapse all

    Probability in percentage, returned as an N-by-M matrix. The probability that the instantaneous signal power of the jth channel is above its average signal power by relpower(i,j), in dB, is prob(i)/100. N equals the number of rows in relpower and M equals the number of signals provided to the powermeter object.

    If the PowerRange property is not set sufficiently large, the computed CCDF curve may not reach some relative power values in relpower and the corresponding values in prob is NaN.

    Data Types: double

    Version History

    Introduced in R2022a

    See Also

    Objects

    Functions