probability

Use CCDF to find probability for specified relative power

Since R2022a

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.

Examples

Find Relative Power for Specified Probability

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)

Find the relative power for the given probability.

relativepwr = relativePower(pm,prob)

relativepwr = 
3.0000

Input Arguments

meter — Power meter

powermeter system object

Power meter, specified as a powermeter System object™.

relpower — Relative power

column vector

Relative power in dB, specified as a column vector.

Data Types: single | double

Output Arguments

prob — Probability

N-by-M matrix

Probability in percentage, returned as an N-by-M matrix. The probability that the instantaneous signal power of the j^th 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