(Not recommended) Probability of relative power value using CCDF
comm.CCDF is not recommended. Use
powermeter instead. For information on updating your code, see Version History.
returns the probability, as a percentage in the range [0, 100], that the power level of a
signal is above its average power by the specified level
P = getProbability(
R. The input
ccdf specifies the complementary cumulative distribution function
(CCDF) curves of the signal of interest. For the ith channel in the input
signal, the function evaluates the corresponding CCDF curve at relative power value
Before calling the
getProbability function, you must obtain the CCDF
curves of the signal of interest by calling the
System object™ on the signal.
Obtain CCDF Curves and Probabilities
Generate a unit variance AWGN signal and a dual-tone signal.
n = [0:5e3-1].'; s1 = randn(5e3,1); % AWGN signal s2 = sin(0.01*pi*n) + sin(0.03*pi*n); % Dual-tone signal
Create a CCDF measurement object.
ccdf = comm.CCDF;
Obtain the CCDF curves of the signals.
Plot the resulting CCDF curves.
Find the probability that the AWGN signal power is 5 dB above its average power and the probability that the dual-tone signal power is 3 dB above its average power.
P = getProbability(ccdf,[5 3])
P = 2×1 7.9551 21.1421
ccdf — CCDF measurements
comm.CCDF System object
CCDF measurements, specified as a
System object. The object must contain CCDF curves. To obtain CCDF curves, call the
object on the input signal of interest.
R — Relative power value
numeric scalar | numeric row vector
Relative power value, specified as one of these options.
Numeric scalar — The function evaluates each CCDF curve at the relative power value
Numeric row vector — The function evaluates the ith CCDF curve in the input
ccdfat relative power value
PowerUnits property of the object specifies
whether the relative power value is returned in a dB scale or linear scale.
P — CCDF probability of relative power value
numeric column vector
CCDF probability of the relative power value, returned as a numeric column vector
with values in the range [0, 100]. A value of 100 corresponds to a probability of 1.0.
P(i)/100 is the probability value of the
channel corresponding to the ith CCDF curve in the input
Version HistoryIntroduced in R2012a
R2023a: To be removed
System object runs without warning, but the Code Analyzer indicates that
com.CCDF will be removed in a future release. Use