hsvplot

(Not recommended) Plot Hankel singular values

hsvplot is not recommended. Use reducespec along with view (balanced) instead. For more information on updating your code, see Version History.

Syntax

hsvplot(sys)
hsvplot(AX,sys,...)
hsvplot(...,numOpts,plotOpts)
h = hsvplot(___)


Description

hsvplot(sys) plots the Hankel singular values (HSVs) of the LTI model sys. See balred 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. Reduced-order models of various orders can be obtained by dropping the states associated with the smallest HSVs. hsvplot also shows the maximum approximation error as a function of the approximation order (number of states in reduced-order model).

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

hsvplot(...,numOpts,plotOpts) specifies additional options for computing and plotting the results. Use balredOptions to create numOpts and hsvoptions to create plotOpts.

h = hsvplot(___) returns the plot handle h to the Hankel singular value plot. 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.

Examples

Set Properties in HSV Plot

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

Create an options set for hsvplot that sets the Yscale property.

P = hsvoptions;
P.YScale = 'linear';

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

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

hsvplot is not recommended. Use reducespec along with view instead. In this case, set plot options for the view function using name-value arguments, where the name corresponds to a property of hsvoptions.

R = reducespec(sys,"balanced");
view(R,YScale="linear")

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.

Version History

Introduced before R2006a

R2023b: Not recommended

hsvplot is not recommended. Use reducespec along with view (balanced) instead.

This table shows some typical usages of hsvplot and how to update your code to use reducespec and view instead.

Not Recommended	Recommended
hsvplot(sys)	R = reducespec(sys,"balanced"); view(R)
plotopt = hsvoptions(YScale="linear"); hsvplot(sys,plotopt)	R = reducespec(sys,"balanced"); view(R,YScale="linear")
numopt = balredOptions(ErrorBound="relative"); hsvplot(sys,numopt)	R = reducespec(sys,"balanced"); R.Options.Goal = "relative"; hsvplot(sys,numopt)