Exposable Parameters and Modelica Blocks

Learn about exposing parameters in Modelica blocks.

Exposing Parameters with Modelica Blocks

You can also define the values of Modelica block parameters using expressions with exposable parameters. Not all Modelica block parameters support expressions with exposed parameters; the restrictions are similar to those for Twin Activate block parameters, mainly that the block parameter should not be structural.

Exposable parameters with Modelica blocks

The following is a model of a Sallen-Key low-pass filter:



The filter transfer function can be expressed as follows:



The filter is usually specified in terms of its cutoff frequency F0 = ω0/(2π), quality factor Q = 1/a, and gain H. These parameters will be used as exposable parameters for this model. The resistor and capacitor values should be computed as a function of these parameters.

The system of equations defining the resistor and capacitor values as functions of filter parameters is underdetermined; for example, C1 and R3 can be chosen arbitrarily, and the other values computed as follows:

k=2*pi*F0*C1; a=1/Q; m=a^2/4 +(H-1); C2=m*C1; R1=2/(a*k); R2=a/(2*m*k); R4=R3/(H-1);

This OML script is placed in the Context of the diagram containing the model of the filter. The diagram is then placed inside the Super Block in the following model:


Auto-masking the Super Block determines the free parameters of the model:



Code generation can now be used; however, this would expose R3 and C1 in addition to the filter parameters. To set the values of R3 and C1 once and for all, these values can be provided numerically in the mask before applying the code generator, for example:


After the application of code generation, the following mask is generated, showing the exposed parameters:



As expected, the filter parameters are exposed.

Mixing Twin Activate and Modelica Blocks in Models

The process of defining, manipulating, and exposing parameters is similar for Twin Activate and Modelica blocks. Indeed, what is referred to as Modelica blocks, that is Twin Activate blocks representing Modelica components, are parameterized in the same way as “regular” Twin Activate blocks. So, not only can Twin Activate and Modelica blocks with exposable parameters be used in the same model, but the same exposable parameters can be used in the expressions used to define the parameter values of both types of blocks.

An example of an electromechanical system modeled using Modelica blocks and controlled by a discrete-time controller implemented with Twin Activate blocks, is considered here. The electromechanical part consists of a DC motor controlled by an input voltage, rotating a mass attached to a grounded spring damper system.



The inertia of the mass is assumed to be mR2/2. The parameters m and R should be exposed.

This diagram is included in the following diagram, which also contains the control action realized by a discrete transfer function “regular” Twin Activate block.


The denominator of the transfer function is fixed (chosen to obtain infinite gain at zero frequency to reject constant bias); the numerator (vector) is the control parameter, which should be exposed. The controller input is the difference between the measured angle and a reference angle. The measured angle is obtained by sampling the actual output and adding measurement noise.

You can see the complete model in the following diagram where the measurement noise and the reference angle are provided. A Scope plots the actual angle and the reference angle. The frequency of the sampling is set to 10Hz. The parameter values are m=1, R=2 and num= [-0.1,0.04].



Applying code generation to the block exposes the parameters as expected:



You can now perform simulations with different parameter values by providing new values in the mask. For example, the robustness can be examined by changing the value of R:



Similarly, the values of m and num can be modified. Note however that the length of num must be 2 and cannot be changed as exposable parameter sizes are fixed. In the case of the transfer function blocks in particular, the length of the numerator vector must one less than the degree of the denominator. So, for example if the transfer function -0.01/(z2-z) is desired, then the value of the num parameter should be set to [0,-0.01], instead of the usual [-0.01]:

If an OML script is used to perform parameter sweeps on the model, this new model provides much better performance than the original model.