# probability

Use CCDF to find probability for specified relative power

Since R2022a

## Syntax

``prob = probability(meter,relpower)``

## Description

example

````prob = probability(meter,relpower)` finds the probability `prob` in percent that the instantaneous signal power is above the average signal power by `relpower` dB.```

## Examples

collapse all

Compute the average power measurement of the generated voltage signal.

```x = complex(rand(10000,1)-0.5,rand(10000,1)-0.5); pm = powermeter(ComputeCCDF=true); averagePower = pm(x); % power in dB```

Compute the probability that the instantaneous power of the signal is 3 dB above the average power.

`prob = probability(pm,3) % probability in percentage`
```prob = 7.6009 ```

Plot the CCDF curve.

`plotCCDF(pm,GaussianReference=true)` Find the relative power for the given probability.

`relativepwr = relativePower(pm,prob)`
```relativepwr = 3.0000 ```

## Input Arguments

collapse all

Power meter, specified as a `powermeter` System object™.

Relative power in dB, specified as a column vector.

Data Types: `single` | `double`

## Output Arguments

collapse all

Probability in percentage, returned as an N-by-M matrix. The probability that the instantaneous signal power of the jth channel is above its average signal power by `relpower`(i,j), in dB, is `prob`(i)/100. N equals the number of rows in `relpower` and M equals the number of signals provided to the `powermeter` object.

If the `PowerRange` property is not set sufficiently large, the computed CCDF curve may not reach some relative power values in `relpower` and the corresponding values in `prob` is `NaN`.

Data Types: `double`

## Version History

Introduced in R2022a