Control System Toolbox™

setoptions - Set plot options for response plot

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

setdelaymodel

sgrid