view

Plot state contributions when using balanced truncation method

Since R2023b

Syntax

view(R,type)

view(R)

view(___,Parent=parent)

view(___,Name=Value)

hsvp = view(___)

view(R,"-help")

Description

Use view to graphically analyze the model and select a model order reduction criteria from a model order reduction task created using reducespec. For BalancedTruncation and SparseBalancedTruncation objects, you can visualize the state contributions as either Hankel singular values or normalized state energies. For the full workflow, see Task-Based Model Order Reduction Workflow.

view(R,type) creates a plot that helps you select the order of the reduced model. R specifies the model order reduction (MOR) specification object. Use the type argument to specify the plot type as either "sigma", "energy", or "loss".

view(R) plots the default plot type for the model order reduction algorithm of R. For balanced truncation methods, this syntax plots Hankel singular values and associated error bounds.

view(___,Parent=parent) creates a plot in the specified parent graphics container, such as a Figure or TiledChartLayout. Use this syntax when you want to create a plot in a specified open figure or when creating apps in App Designer. You can specify the parent container after any of the input argument combinations in the previous syntaxes.

view(___,Name=Value) specifies additional options for customizing the appearance of Hankel singular value plots using one or more name-value arguments. For example, view(R,"sigma",YScale="Linear") plots the Hankel singular values using a linear scale for y axis. For a list of available options, see hsvoptions.

hsvp = view(___) returns an HSVPlot object. To customize your plot, modify properties of the plot object using dot notation.

view(R,"-help") returns help specific to the model order specification object R. The returned help shows plot types and syntaxes applicable to R.

Examples

Reduce Order of LTI Model Using Balanced Truncation

This example shows how to create a model order reduction specification for a dense LTI model using the balanced truncation method.

For this example, generate a random discrete-time state-space model with 40 states.

rng(0)
sys = drss(40);

Plot the Bode response.

bode(sys)

Create the specification object.

R = reducespec(sys,"balanced");

Notice that reducespec does not perform any computation and creates only the object. This allows you to set additional options before running the model order reduction algorithm, such as relative error control as the algorithm objective.

R.Options.Algorithm = "relative";

For balanced truncation, you can visualize the contributions in terms of the Hankel singular values or normalized energies. By default, the view function plots Hankel singular values.

view(R)

For this example, select an order of 15 since it is the first order with a relative error less than 1e-4. In general, you select the order based on the desired absolute or relative fidelity. Then, compute the reduced-order model.

rsys = getrom(R,Order=15);

Plot the Bode response of both models.

bode(sys,rsys,'r--')
legend("Original","Order 15")

Customize State Contribution Plots

This example shows how to customize the state contribution plots obtained using the view function in the model order reduction workflow.

For this example, create a model order reduction specification for a dense LTI model using the balanced truncation method. Generate a random discrete-time state-space model with 40 states.

rng(0)
sys = drss(40);

Create a specification object and compute the information.

R = reducespec(sys,"balanced");
R = process(R);

Visualize the Hankel singular values.

view(R)

To customize the plots for balanced truncation methods, you can use hsvoptions properties as input arguments.

h = view(R,"sigma",YScale="linear");

You can further customize this plot by modifying the properties of h.

h.AxesStyle.GridVisible = "off";

Input Arguments

R — Model order reduction specification object

BalancedTruncation object | SparseBalancedTruncation object

Model order reduction specification object created using reducespec, specified as a BalancedTruncation or SparseBalancedTruncation object.

type — Plot type

"sigma" | "energy" | "loss"

Plot type, specified as one of these strings.

• "sigma" — Bar chart of Hankel singular values and associated error bounds.

• "energy" — Bar chart of normalized state energies.

• "loss" — Bar chart of neglected fraction of total energy.

If you do not specify this argument, the functions uses "sigma" for balanced truncation objects.

parent — Parent graphics container

Figure object | TiledChartLayout object | UIFigure object | UIGridLayout object | UIPanel object | UITab object | Axes object | UIAxes object

Parent graphics container, specified as one of these objects:

• Figure

• TiledChartLayout

• UIFigure

• UIGridLayout

• UIPanel

• UITab

You can also specify parent as an Axes or UIAxes object, which sets the plot parent to the parent of the specified axes object.

Output Arguments

hsvp — HSV plot object

HSVPlot object

HSV plot object, returned as an HSVPlot chart object. To customize the plot, modify the properties of hsvp using dot notation.

References

[1] Benner, Peter, Jing-Rebecca Li, and Thilo Penzl. “Numerical Solution of Large-Scale Lyapunov Equations, Riccati Equations, and Linear-Quadratic Optimal Control Problems.” Numerical Linear Algebra with Applications 15, no. 9 (November 2008): 755–77. https://doi.org/10.1002/nla.622.

[2] Benner, Peter, Martin Köhler, and Jens Saak. “Matrix Equations, Sparse Solvers: M-M.E.S.S.-2.0.1—Philosophy, Features, and Application for (Parametric) Model Order Reduction.” In Model Reduction of Complex Dynamical Systems, edited by Peter Benner, Tobias Breiten, Heike Faßbender, Michael Hinze, Tatjana Stykel, and Ralf Zimmermann, 171:369–92. Cham: Springer International Publishing, 2021. https://doi.org/10.1007/978-3-030-72983-7_18.

[3] Varga, A. “Balancing Free Square-Root Algorithm for Computing Singular Perturbation Approximations.” In [1991] Proceedings of the 30th IEEE Conference on Decision and Control, 1062–65. Brighton, UK: IEEE, 1991. https://doi.org/10.1109/CDC.1991.261486.

[4] Green, M. “A Relative Error Bound for Balanced Stochastic Truncation.” IEEE Transactions on Automatic Control 33, no. 10 (October 1988): 961–65. https://doi.org/10.1109/9.7255.

Version History

Introduced in R2023b

R2025a: Axes=AX input argument not recommended

Specifying the axes for plotting using Axes=AX is not recommended. Specify a parent graphics container using Parent=parent instead.

For example, the following code plots the response in an axes object obtained from a figure.

f = figure;
ax = gca;
view(R,Axes=ax)

To update the code, set the parent of the plot to the figure instead.

f = figure;
view(R,Parent=f)

R2025a: Specify parent graphics container

You can now plot mode information in a parent graphics container, such as a Figure or TiledChartLayout object, using the parent argument.

Specifying parent as an Axes or UIAxes object sets the plot parent to the parent of the specified axes object.

R2024b: Select model order using new criteria based on total neglected state energy

You can now select model order based on the fraction of total energy you want to neglect. The BalancedTruncation and SparseBalancedTruncation objects now contain a new property Loss to store the energy loss as a fraction of total energy. You can use view(R,"loss") to visualize a bar chart of neglected fraction of total energy and getrom with the new name-value argument MaxLoss to pick the reduced order based on maximum energy loss as a fraction of total energy. For example, to obtain a reduced model that neglects 1% of the total energy, you can specify rsys = getrom(R,MaxLoss=0.01).