# passiveplot

Compute or plot passivity index as function of frequency

## Syntax

## Description

`passiveplot(`

plots
the relative passivity indices of the dynamic system `G`

)`G`

as
a function of frequency. When `I + G`

is minimum
phase, the relative passivity indices are the singular values of ```
(I
- G)(I + G)^-1
```

. The largest singular value measures the
relative excess `(R < 1)`

or shortage ```
(R
> 1)
```

at each frequency. See `getPassiveIndex`

for
more information about the meaning of the passivity index.

`passiveplot`

automatically chooses the frequency
range and number of points for the plot based on the dynamics of `G`

.

If `G`

is a model with complex coefficients, then
in:

Log frequency scale, the plot shows two branches, one for positive frequencies and one for negative frequencies. The arrows indicate the direction of increasing frequency values for each branch.

Linear frequency scale, the plot shows a single branch with a symmetric frequency range centered at a frequency value of zero.

`passiveplot(___,`

plots the input,
output, or I/O passivity index, depending on the specified type value.`type`

)

You can use this syntax with any of the previous input-argument combinations.

`passiveplot(___,`

plots the passivity
index for frequencies specified by `w`

)`w`

. You can specify a
frequency range or a vector of frequencies.

`passiveplot(___,`

plots the passivity index with the plotting options specified in
`plotoptions`

)`plotoptions`

. Settings you specify in
`plotoptions`

override the plotting preferences for the
current MATLAB^{®} session. This syntax is useful when you want to write a script to
generate multiple plots that look the same regardless of the local
preferences.

`passiveplot(___,`

plots the passivity index for any combination of `type`

,`w`

,`plotoptions`

)`type`

,
`w`

, and `plotoptions`

in any
order.

You can use this syntax with any of the previous input-argument combinations.

`passiveplot(___,`

plots the passivity index with the options set specified in
`plotoptions`

)`plotoptions`

. You can use these options to customize the
plot appearance using the command line. Settings you specify in
`plotoptions`

override the preference settings in the
MATLAB session in which you run `passiveplot`

.
Therefore, this syntax is useful when you want to write a script to generate
multiple plots that look the same regardless of the local preferences.

## Examples

## Input Arguments

## Output Arguments

## Version History

**Introduced in R2016a**

## See Also

`isPassive`

| `getPassiveIndex`

| `getSectorIndex`

| `sectorplot`

| `sectorplotoptions`