# 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.

## Syntax

``R = getPercentileRelativePower(ccdf,P)``

## 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.