blockLimPID_Input
Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).
Information
This model is taken completely from Modelica.Blocks.Continuous.LimPID. The only difference is, that the values for u_s (setpoint value) and u_m (measurement signal) are submitted to the model via input variables and not using connectors. This approach is more suitable for the use of this controller in BaseColumn, since it avoids unnecessary generation of warnings in Dymola.
The following rest of the documentation is also from Modelica.Blocks.Continuous.LimPID:
Via parameter controllerType either P, PI, PD, or PID can be selected. If, e.g., PI is selected, all components belonging to the D-part are removed from the block (via conditional declarations). The example model Modelica.Blocks.Examples.PID_Controller demonstrates the usage of this controller. Several practical aspects of PID controller design are incorporated according to chapter 3 of the book:
- Åström K.J., and Hägglund T.:
- PID Controllers: Theory, Design, and Tuning. Instrument Society of America, 2nd edition, 1995.
Besides the additive proportional, integral and derivative part of this controller, the following features are present:
- The output of this controller is limited. If the controller is in its limits, anti-windup compensation is activated to drive the integrator state to zero.
- The high-frequency gain of the derivative part is limited to avoid excessive amplification of measurement noise.
- Setpoint weighting is present, which allows to weight the setpoint in the proportional and the derivative part independantly from the measurement. The controller will respond to load disturbances and measurement noise independantly of this setting (parameters wp, wd). However, setpoint changes will depend on this setting. For example, it is useful to set the setpoint weight wd for the derivative part to zero, if steps may occur in the setpoint signal.
The parameters of the controller can be manually adjusted by performing simulations of the closed loop system (= controller + plant connected together) and using the following strategy:
- Set very large limits, e.g., yMax = Modelica.Constants.inf
- Select a P-controller and manually enlarge parameter k (the total gain of the controller) until the closed-loop response cannot be improved any more.
- Select a PI-controller and manually adjust parameters k and Ti (the time constant of the integrator). The first value of Ti can be selected, such that it is in the order of the time constant of the oscillations occuring with the P-controller. If, e.g., vibrations in the order of T=10 ms occur in the previous step, start with Ti=0.01 s.
- If you want to make the reaction of the control loop faster (but probably less robust against disturbances and measurement noise) select a PID-Controller and manually adjust parameters k, Ti, Td (time constant of derivative block).
- Set the limits yMax and yMin according to your specification.
- Perform simulations such that the output of the PID controller goes in its limits. Tune Ni (Ni*Ti is the time constant of the anti-windup compensation) such that the input to the limiter block (= limiter.u) goes quickly enough back to its limits. If Ni is decreased, this happens faster. If Ni=infinity, the anti-windup compensation is switched off and the controller works bad.
Initialization
This block can be initialized in different ways controlled by parameter initType. The possible values of initType are defined in Modelica.Blocks.Types.InitPID. This type is identical to Types.Init, with the only exception that the additional option DoNotUse_InitialIntegratorState is added for backward compatibility reasons (= integrator is initialized with InitialState whereas differential part is initialized with NoInit which was the initialization in version 2.2 of the Modelica standard library).
Based on the setting of initType, the integrator (I) and derivative (D) blocks inside the PID controller are initialized according to the following table:
initType |
I.initType |
D.initType |
NoInit |
NoInit |
NoInit |
SteadyState |
SteadyState |
SteadyState |
InitialState |
InitialState |
InitialState |
InitialOutputand initial equation: y = y_start |
NoInit |
SteadyState |
DoNotUse_InitialIntegratorState |
InitialState |
NoInit |
In many cases, the most useful initial condition is SteadyState because initial transients are then no longer present. If initType = Init.SteadyState, then in some cases difficulties might occur. The reason is the equation of the integrator:
der(y) = k*u;
The steady state equation "der(x)=0" leads to the condition that the input u to the integrator is zero. If the input u is already (directly or indirectly) defined by another initial condition, then the initialization problem is singular (has none or infinitely many solutions). This situation occurs often for mechanical systems, where, e.g., u = desiredSpeed - measuredSpeed and since speed is both a state and a derivative, it is natural to initialize it with zero. As sketched this is, however, not possible. The solution is to not initialize u_m or the variable that is used to compute u_m by an algebraic equation.
If parameter limitAtInit = false, the limits at the output of this controller block are removed from the initialization problem which leads to a much simpler equation system. After initialization has been performed, it is checked via an assert whether the output is in the defined limits. For backward compatibility reasons limitAtInit = true. In most cases it is best to use limitAtInit = false.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Types.SimpleController | controllerType | Modelica.Blocks.Types.SimpleController.PID | Type of controller |
| Real | k | 1 | Gain of controller |
| Modelica.Units.SI.Time | Ti | 0.5 | Time constant of Integrator block |
| Modelica.Units.SI.Time | Td | 0.1 | Time constant of Derivative block |
| Real | yMax | Upper limit of output | |
| Real | yMin | -yMax | Lower limit of output |
| Real | wp | 1 | Set-point weight for Proportional block (0..1) |
| Real | wd | 0 | Set-point weight for Derivative block (0..1) |
| Real | Ni | 0.9 | Ni*Ti is time constant of anti-windup compensation |
| Real | Nd | 10 | The higher Nd, the more ideal the derivative block |
| SI.Time | unitTime | 1 | |
| Initialization | |||
| Modelica.Blocks.Types.Init | initType | Modelica.Blocks.Types.Init.InitialOutput | Type of initialization (1: no init, 2: steady state, 3: initial state, 4: initial output) |
| Boolean | limitsAtInit | true | = false, if limits are ignored during initializiation |
| Real | xi_start | 0 | Initial or guess value value for integrator output (= integrator state) |
| Real | xd_start | 0 | Initial or guess value for state of derivative block |
| Real | y_start | 0 | Initial value of output |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Interfaces.RealOutput | y | Connector of actuator output signal | |
| Modelica.Blocks.Interfaces.RealOutput | output_u_s | Connector of actuator output signal | |
| Modelica.Blocks.Interfaces.RealOutput | output_u_m | Connector of actuator output signal | |
| Modelica.Blocks.Interfaces.RealInput | input_u_m | ||
| Modelica.Blocks.Interfaces.RealInput | input_u_s |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Real | u_s | ||
| Real | u_m | ||
| Real | controlError | u_s - u_m | Control error (set point - measurement) |
| Modelica.Blocks.Math.Add | addP | ||
| Modelica.Blocks.Math.Add | addD | ||
| Modelica.Blocks.Math.Gain | P | ||
| Modelica.Blocks.Continuous.Integrator | I | ||
| Modelica.Blocks.Continuous.Derivative | D | ||
| Modelica.Blocks.Math.Gain | gainPID | ||
| Modelica.Blocks.Math.Add3 | addPID | ||
| Modelica.Blocks.Math.Add3 | addI | ||
| Modelica.Blocks.Math.Add | addSat | ||
| Modelica.Blocks.Math.Gain | gainTrack | ||
| Modelica.Blocks.Nonlinear.Limiter | limiter | ||
| Modelica.Blocks.Sources.Constant | Dzero | ||
| Modelica.Blocks.Sources.Constant | Izero |