# nicholsplot

Plot Nichols frequency responses with additional plot customization options

## Syntax

## Description

`nicholsplot`

lets you plot the Nichols frequency response of a
dynamic system model with a broader range of plot customization options than
`nichols`

. You can use `nicholsplot`

to obtain the plot
handle and use it to customize the plot, such as modify the axes labels, limits and units. You
can also use `nicholsplot`

to draw a Nichols plot on an existing set of axes
represented by an axes handle. To customize an existing Nichols plot using the plot
handle:

Obtain the plot handle

Use

`getoptions`

to obtain the option setUpdate the plot using

`setoptions`

to modify the required options

For more information, see Customizing Response Plots from the Command Line. To create Nichols plots with default options or to
extract the Nichols frequency response data, use `nichols`

.

plots the frequency Nichols response of the dynamic system model
`h`

= nicholsplot(`sys`

)`sys`

and returns the plot handle `h`

to the plot. You
can use this handle `h`

to customize the plot with the `getoptions`

and `setoptions`

commands. If `sys`

is a multi-input,
multi-output (MIMO) model, then `nicholsplot`

produces a grid of Nichols
plots, each plot displaying the frequency response of one I/O pair.

plots Nichols responses for frequencies specified by the frequencies in
`h`

= nicholsplot(___,`w`

)`w`

.

If

`w`

is a cell array of the form`{wmin,wmax}`

, then`nicholsplot`

plots the response at frequencies ranging between`wmin`

and`wmax`

.If

`w`

is a vector of frequencies, then`nicholsplot`

plots the response at each specified frequency.

You can use `w`

with any of the input-argument combinations in
previous syntaxes.

See `logspace`

to generate logarithmically spaced
frequency vectors.

plots the Nichols frequency response with the options set specified in
`h`

= nicholsplot(___,`plotoptions`

)`plotoptions`

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

overrides the preference settings in the MATLAB^{®} session in which you run `nicholsplot`

. 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 before R2006a**