getProbability

System object: comm.CCDF
Package: comm

Get the probability for a given relative power value

Syntax

P = getProbability(H,R)

Description

P = getProbability(H,R) finds the probability, P, of the power level of the signal of interest being R dBs (if PowerUnits equals 'dBW', or 'dBm') or Watts (if PowerUnits equals 'Watts') above its average power. P is a column vector with the i-th element corresponding to the probability value for the i-th input channel. Input R can be a double precision scalar or a vector with a number of elements equal to the number of input channels. If R is a scalar, then all the probability values in P correspond to the same relative power specified in R. If R is a vector, then the ith element of P contains a probability value for the i-th channel and for the relative power specified in the i-th element of R.

For the i-th input channel, this method evaluates the CCDF curve at relative power value R(i)

Examples

Obtain CCDF curves for a unit variance AWGN signal and a dual- tone signal. Find the probability that the AWGN signal power is 5 dB above its average power and that the dual-tone signal power is 3 dB above its average power.

 n = [0:5e3-1].';
 s1 = randn(5e3,1);                    % AWGN signal
 s2 = sin(0.01*pi*n)+sin(0.03*pi*n);   % dual-tone signal
 hCCDF = comm.CCDF;          
 step(hCCDF,[s1 s2]);                
 plot(hCCDF)                           % plot CCDF curves
 legend('AWGN','Dual-tone')
 P = getProbability(hCCDF,[5 3])       % get probabilities