hsvplot

Plot Hankel singular values and return plot handle

Syntax

h = hsvplot(sys)
hsvplot(sys)
hsvplot(sys, AbsTol',ATOL,'RelTol',RTOL,'Offset',ALPHA)
hsvplot(AX,sys,...)

Description

h = hsvplot(sys) plots the Hankel singular values of an LTI system sys and returns the plot handle h. You can use this handle to customize the plot with the getoptions and setoptions commands. See hsvoptions for a list of some available plot options.

hsvplot(sys) plots the Hankel singular values of the LTI model sys. See hsvd for details on the meaning and purpose of Hankel singular values. The Hankel singular values for the stable and unstable modes of sys are shown in blue and red, respectively.

hsvplot(sys, AbsTol',ATOL,'RelTol',RTOL,'Offset',ALPHA) specifies additional options for computing the Hankel singular values.

hsvplot(AX,sys,...) attaches the plot to the axes with handle AX.

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

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')

Tips

  • Both hsvd 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.

Introduced before R2006a