setoptions (Control System Toolbox)

Set plot options for response plots

Syntax

setoptions(h, PlotOpts)
setoptions(h, 'Property1', 'value1', ...)
setoptions(h, PlotOpts, 'Property1', 'value1', ...)

Description

setoptions(h, PlotOpts) sets preferences for response plot using the plot handle. h is the plot handle, PlotOpts is a plot options handle containing information about plot options.

There are two ways to create a plot options handle:

Use getoptions, which accepts a plot handle and returns a plot options handle.

```
p = getoptions(h)
```

Create a default plot options handle using one of the following commands:

bodeoptions -- Bode plots
hsvoptions -- Hankel singular values plots
nicholsoptions -- Nichols plots
nyquistoptions -- Nyquist plots
pzoptions -- Pole/zero plots
sigmaoptions -- Sigma plots
timeoptions -- Time plots (step, initial, impulse, etc.)

For example,
- ```
p = bodeoptions
```
returns a plot options handle for Bode plots.

setoptions(h, 'Property1', 'value1', ...) assigns values to property pairs instead of using PlotOpts. To find out what properties and values are available, type help <function>options. For example, for Bode plots type

```
help bodeoptions
```

setoptions(h, PlotOpts, 'Property1', 'value1', ...) first assigns plot properties as defined in @PlotOptions, and then overrides any properties governed by the specified property/value pairs.

Examples

To change frequency units, first create a Bode plot.

sys=tf(1,[1 1]);
h-bodeplot(sys)     % Create a Bode plot with plot handle h.

Now, change the frequency units from rad/s to Hz.

p=getoptions(h);    % Create a plot options handle p.
p.FreqUnits = 'Hz'; % Modify frequency units.
setoptions(h,p);    % Apply plot options to the Bode plot and 
                    % render.

To change the frequency units using property/value pairs, use this code.

sys=tf(1,[1 1]);
h=bodeplot(sys);
setoptions(h,'FreqUnits','Hz');

The result is the same as the first example.

See Also
getoptions Get a plot options handle

set sgrid