Documentation Center

  • Trial Software
  • Product Updates


Set plot options for response plot


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


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 for a particular plot, type help <function>options. For example, for Bode plots type

help bodeoptions

For a list of the properties and values available for each plot type, see Properties and Values Reference.

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.


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]);

The result is the same as the first example.

See Also

Was this topic helpful?