(Not recommended) Relative power value for given percentile using CCDF
comm.CCDF is not recommended. Use
powermeter instead. For information on updating your code, see Version History.
returns the relative power value of a signal for the specified percentile value
R = getPercentileRelativePower(
P. The input
ccdf specifies the complementary
cumulative distribution function (CCDF) curves of the signal of interest. The function
returns the power level by which the signal is above its average power
P percent of the time. A percentile of
P = 100
corresponds to a probability of 1.0. For the ith channel in the input
signal, the function evaluates the inverse of the corresponding CCDF curve at probability
Before calling the
getPercentileRelativePower function, you must obtain the CCDF
curves of the signal of interest by calling the
System object™ on the signal.
Obtain CCDF Curves and Relative Power Levels
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 curves.
Find the relative power levels of the signals. The AWGN signal is 8.1929 dB above its average power 1 percent of the time. The dual-tone signal is 3.5493 dB above its average power 10 percent of the time.
RPW = getPercentileRelativePower(ccdf,[1 10])
RPW = 2×1 8.1923 3.5493
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.
P — Percentile
numeric scalar | numeric row vector
Percentile, specified as one of these options.
Numeric scalar in the range [0, 100] — The function evaluates the inverse of each CCDF curve at probability value
Numeric row vector with values in the range [0, 100] — The function evaluates the inverse of the ith CCDF curve in the input
ccdfat probability value
R — Relative power value
numeric column vector
Relative power value, returned as a numeric column vector.
R(i) is the relative power value returned for
the channel corresponding to ith CCDF curve in the input
PowerUnits property of the object
specifies whether the relative power value is returned in a dB scale or linear
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