SparseModalTruncationOptions

Options for sparse model order reduction with modal truncation method

Since R2023b

expand all in page

Description

This object contains model order reduction options of sparse linear time-invariant models, and is contained in the Options property of a SparseModalTruncation object R created using reducespec. To configure these options, use dot notation, for example, R.Options.ModeOnly = true.

For the full workflow, see Task-Based Model Order Reduction Workflow.

Properties

expand all

Frequency range of interest, specified as a vector of form [fmin,fmax]. When you specify a value for this property, the algorithm computes only modes in this frequency range.

By default, the focus is unspecified ([0 inf]) and the algorithm computes the MaxOrder modes with smallest magnitude.

Maximum order of the modal approximation, specified as a positive integer. This value limits the number of eigenvalues computed by the Krylov-Schur iterations and the order of the modal approximation of the original sparse model.

Flag to only compute modes for the original system sys, specified as a logical 0 (false) or 1 (true).

  • When R.Options.ModeOnly is true, the software computes only the pole locations, damping, and natural frequency of the poles, which correspond to the Mode, Damping, and Frequency properties of R, respectively.

  • When R.Options.ModeOnly is false, the software computes a full modal decomposition and populates all properties of R.

Frequency for evaluating and matching DC contributions, specified as a nonnegative scalar.

For models with integrators, you cannot evaluate modal contributions at DC since the DC gain is infinite. To evaluate modal contributions and match gains at a different frequency, set the property to a positive value. The default value of this property corresponds to the DC contributions.

Input scaling factors, specified as a vector of length Nu, where Nu is the number of inputs in the original model sys.

Use this option to emphasize specific input channels in sys. The software evaluates the modal contributions for the scaled system.

This affects only the normalized DC contribution (R.DCGain). For the input scaling factor Du and output scaling factor Dy, the normalized DC contribution of Gk(s) in continuous time is obtained as

‖DyGk(0)Du‖‖DyG(0)Du‖

In discrete time, the software uses the first time samples Gk(1) and G(1).

Output scaling factors, specified as a vector of length Ny, where Ny is the number of outputs in the original model sys.

Use this option to emphasize specific output channels in sys. The software evaluates the modal contributions for the scaled system.

This affects only the normalized DC contribution (R.DCGain). For the input scaling factor Du and output scaling factor Dy, the normalized DC contribution of Gk(s) in continuous time is obtained as

‖DyGk(0)Du‖‖DyG(0)Du‖

In discrete time, the software uses the first time samples Gk(1) and G(1).

Tolerance for identifying converged eigenvalues in Krylov-Schur iterations, specified as a positive scalar.

Relative accuracy of modal contribution, specified as a scalar between 0 and 1.

This option limits the condition number of the block diagonalizing transformation to roughly SepTol/eps. Increasing SepTol helps yield smaller modal components at the expense of accuracy.

Show or hide progress report, specified as either "off" or "on".

Version History

Introduced in R2023b

See Also

|

Topics