Main Content

hsvoptions

Plot options for hsvplot

Syntax

P = hsvoptions
P = hsvoptions('cstpref')

Description

P = hsvoptions returns a list of available options for Hankel singular value (HSV) plots with default values set. Use dot notation to change the option values. You can use these options to customize the appearance of a Hankel singular value plot created with hsvplot.

P = hsvoptions('cstpref') initializes the plot options you selected in the Control System Toolbox™ Preferences Editor dialog box. For more information about the editor, see Toolbox Preferences Editor.

The Hankel singular-value plot options include:

OptionDescription
Title, XLabel, YLabelLabel text and style
TickLabelTick label style
Grid[off|on]Show or hide the grid
GridColor — [Vector of RGB values in the range [0,1]| color |'none']Color of the grid lines
XlimMode, YlimModeLimit modes
Xlim, YlimAxes limits
YScale[linear|log] Scale for Y-axis

Tips

  • Both balred and hsvplot generate Hankel singular-value plots. hsvplot is useful when you want to customize properties of your plot such as axis limits, scale, and label styles. Use hsvoptions with hsvplot to define properties for your plot. For information on the ways to change properties of your plots, see Ways to Customize Plots.

Examples

collapse all

Use hsvplot to create a Hankel singular-value plot with and customized plot properties.

Create an options set for hsvplot that sets the Yscale property and the title font size.

P = hsvoptions;
P.YScale = 'linear'; 
P.Title.FontSize = 14;

Use the options set to generate an HSV plot. Note the linear y-axis scale in the plot.

h = hsvplot(rss(12),P);

Figure contains an axes. The axes with title Hankel Singular Values and Approximation Error contains 3 objects of type bar, line. These objects represent Unstable modes, Stable modes, Absolute error bound.

hsvplot returns a plot handle. You can use the plot handle to change properties of the existing plot. For example, switch to log scale and turn off the grid.

setoptions(h,'Yscale','log','Grid','Off')

Figure contains an axes. The axes with title Hankel Singular Values and Approximation Error contains 3 objects of type bar, line. These objects represent Unstable modes, Stable modes, Absolute error bound.

Introduced in R2008a