nblocks

Number of control design blocks in generalized LTI model or generalized matrix

Syntax

N = nblocks(M)

Description

N = nblocks(M) returns the number of control design blocks in the generalized LTI model or generalized matrix M.

Examples

Number of Control Design Blocks in Second-Order Filter Model

1. Create a tunable (parametric) model of the second-order filter:

   $$F\left(s\right)=\frac{{\omega }_n^2}{s^2+2\zeta {\omega }_n+{\omega }_n^2},$$

   where the damping ζ and the natural frequency ω_n are tunable parameters.

   wn = realp('wn',3);
   zeta = realp('zeta',0.8);
   F = tf(wn^2,[1 2*zeta*wn wn^2]);

   F is a genss model with two tunable control design blocks, the realp blocks wn and zeta. The blocks wn and zeta have initial values of 3 and 0.8, respectively.

2. Examine the number of tunable blocks in the model using nblocks.

   nblocks(F)

   This command returns the result:

   ans =
   
        6

   F has two tunable parameters, but the parameter wn appears five times — twice in the numerator and three times in the denominator.

3. Rewrite F for fewer occurrences of wn.

   The second-order filter transfer function can be expressed as follows:

   $$F\left(s\right)=\frac{1}{{\left(\frac{s}{{\omega }_n}\right)}^2+2\zeta \left(\frac{s}{{\omega }_n}\right)+1}.$$

   Use this expression to create the tunable filter:

   F = tf(1,[(1/wn)^2 2*zeta*(1/wn) 1])

4. Examine the number of tunable blocks in the new filter model.

   nblocks(F)

   This command returns the result:

   ans =
   
        4

   In the new formulation, there are only three occurrences of the tunable parameter wn. Reducing the number of occurrences of a block in a model can improve performance time of calculations involving the model. However, the number of occurrences does not affect the results of tuning the model or sampling the model for parameter studies.

Input Arguments

M — Generalized LTI model or matrix

genss object | genfrd object | genmat object | array

Generalized matrix or model, specified as a generalized LTI model (genss or genfrd object), a generalized matrix (genmat object), or an array of such objects.

Output Arguments

N — Number of control design blocks

integer | integer array

Number of Control Design Blocks in M, returned as an integer when M is a single model or integer array when M is a model array.

If M is a model array, N is an array with the same dimensions as M. Each entry of N is the number of control design blocks in the corresponding entry of M.

If a block appears multiple times in M or an element of M, N reflects the total number of occurrences.

Version History

Introduced in R2011a