full

Convert sparse models to dense storage

Since R2020b

Syntax

fsys = full(sys)

Description

fsys = full(sys) converts the sparss and mechss model sys to dense state-space representation ss. For mechss models, the conversion to dense representation is equivalent to full(sparss(sys)). For other model types, full leaves sys unchanged.

Use the full command to convert small scale sparse models to dense storage to perform operations like pole/zero extraction, model order reduction, and controller design and tuning. Converting to dense storage is not recommended for large scale sparse models as it may saturate available memory and cause severe performance degradation.

Examples

Convert Sparse Second-Order Model to Dense Representation

For this example, consider sparseSOFull.mat that contains a sparse second-order model with 50 nodes.

Load the sparse second-order model and convert it to dense representation using full.

load('sparseSOFull.mat','sys');
fsys = full(sys);
size(fsys)

State-space model with 1 outputs, 1 inputs, and 100 states.

Since, sys is a mechss model, the conversion to dense storage is equivalent to fsys = full(sparss(sys)). The resultant model fsys is a full storage ss model object with 100 states since the mass matrix is full rank.

Compare the storage size of the two representations.

whos

  Name      Size             Bytes  Class     Attributes

  fsys      1x1             164589  ss                  
  sys       1x1               6494  mechss    sparse    

Converting to dense storage is not recommended for large scale sparse models as it may saturate available memory and cause severe performance degradation.

Input Arguments

sys — Sparse state-space model

sparss model object | mechss model object

Sparse state-space model, specified as a sparss or mechss model object. For other model types, full leaves sys unchanged.

Output Arguments

fsys — Dense state-space model

ss model object

Dense state-space model, returned as an ss model object. For more information on dense state-space model representation, see ss.

Version History

Introduced in R2020b