Main Content

getPercentileRelativePower

(To be removed) Relative power value for given percentile using CCDF

comm.CCDF will be removed in a future release. Use powermeter instead. For information on updating your code, see Version History.

Description

example

R = getPercentileRelativePower(ccdf,P) returns the relative power value of a signal for the specified percentile value 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 value P(i)/100.

Before calling the getPercentileRelativePower function, you must obtain the CCDF curves of the signal of interest by calling the ccdf System object™ on the signal.

Examples

collapse all

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.

ccdf([s1 s2]);

Plot the resulting curves.

plot(ccdf)
legend('AWGN','Dual-tone')

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

Input Arguments

collapse all

CCDF measurements, specified as a comm.CCDF System object. The object must contain CCDF curves. To obtain CCDF curves, call the object on the input signal of interest.

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 P/100.

  • Numeric row vector with values in the range [0, 100] — The function evaluates the inverse of the ith CCDF curve in the input ccdf at probability value P(i)/100.

Output Arguments

collapse all

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 ccdf. The PowerUnits property of the object specifies whether the relative power value is returned in a dB scale or linear scale.

Data Types: double

Version History

Introduced in R2012a

expand all

R2024a: To be removed

The comm.CCDF System object will be removed in a future release. Use powermeter instead.

See Also

Objects