# powermeter

Measure power of voltage signal

## Description

The `powermeter`

System object™ computes the power measurements of a voltage signal. The power measurements
include average power, peak power, and peak-to-average power ratio. The object uses the
sliding window method to compute these measurements. For more details, see Algorithms.

To measure the power of a voltage signal:

Create the

`powermeter`

object and set its properties.Call the object with arguments, as if it were a function.

To learn more about how System objects work, see What Are System Objects?

## Creation

### Description

returns a
`meter`

= powermeter`powermeter`

system object that computes power, peak-to-average power
ratio (PAPR), and the complementary cumulative distribution function (CCDF) of the power
of voltage signal. The CCDF helps find the probability that the instantaneous signal power
exceeds a specified level above the average signal power.

sets the `meter`

= powermeter(`Len`

,`Overlap`

,Name=Value)`WindowLength`

property to `Len`

and the `OverlapLength`

property to `Overlap`

. To enable this syntax, set the
`ComputeCCDF`

property to `false`

.

returns a `meter`

= powermeter(`Name=Value`

)`powermeter`

system object with each specified property set to
the specified value. Enclose each property name in quotes. You can use this syntax with
the previous input argument.

## Properties

## Usage

### Description

`[`

computes the average power, peak power, and the peak-to-average power ratio of the input
signal `avgpwr`

,`peakpwr`

,`papr`

] = meter(`x`

)`x`

when the `Measurement`

property is set to `'All'`

. Each column of `x`

is an
independent channel. The object computes the power measurements of each channel of the
input signal independently.

### Input Arguments

### Output Arguments

## Object Functions

To use an object function, specify the
System object as the first input argument. For
example, to release system resources of a System object named `obj`

, use
this syntax:

release(obj)

## Examples

## Algorithms

## Extended Capabilities

## Version History

**Introduced in R2021a**

## See Also

### Objects

### Blocks

### Topics

- Compute Average Power of 256 QAM Signal in MATLAB (Communications Toolbox)