Version_2_1
Version 2.1 (Nov. 11, 2004)
Library
Modelica/UsersGuide/ReleaseNotes
Description
This is a major change with respect to previous versions of the Modelica Standard Library, because many new libraries and components are included and because the input/output blocks (Modelica.Blocks) have been considerably simplified:
- An input/output connector is defined without a hierarchy (this is possible due to new features of the Modelica language). For example, the input signal of a block "FirstOrder" was previously accessed as "FirstOrder.inPort.signal[1]". Now it is accessed as "FirstOrder.u". This simplifies the understanding and usage especially for beginners.
- De-vectorized the Modelica.Blocks library. All blocks in the
Modelica.Blocks library are now scalar blocks. As a result,
the parameters of the Blocks are scalars and no vectors any
more. For example, a parameter "amplitude" that might had
a value of "{1}" previously, has now a value of "1". This simplifies
the understanding and usage especially for beginners.
If a vector of blocks is needed, this can be easily accomplished by adding a dimension to the instance. For example "Constant const[3](k={1,2,3})" defines three Constant blocks. An additional advantage of the new approach is that the implementation of Modelica.Blocks is much simpler and is easier to understand.
The discussed changes of Modelica.Blocks are not backward compatible. A script to automatically convert models to this new version is provided. There might be rare cases, where this script does not convert. In this case models have to be manually converted. In any case you should make a back-up copy of your model before automatic conversion is performed.
The following new libraries have been added:
Modelica.Electrical.Digital | Digital electrical components based on 2-,3-,4-, and 9-valued logic according to the VHDL standard |
Modelica.Electrical.Machines | Asynchronous, synchronous and DC motor and generator models |
Modelica.Math.Matrices | Functions operating on matrices such as solve() (A*x=b), leastSquares(), norm(), LU(), QR(), eigenValues(), singularValues(), exp(), ... |
Modelica.StateGraph | Modeling of discrete event and reactive systems in a convenient way using hierarchical state machines and Modelica as action language. It is based on JGrafchart and Grafcet and has a similar modeling power as StateCharts. It avoids deficiencies of usually used action languages. This library makes the ModelicaAdditions.PetriNets library obsolete. |
Modelica.Utilities.Files | Functions to operate on files and directories (copy, move, remove files etc.) |
Modelica.Utilities.Streams | Read from files and write to files (print, readLine, readFile, error, ...) |
Modelica.Utilities.Strings | Operations on strings (substring, find, replace, sort, scanToken, ...) |
Modelica.Utilities.System | Get/set current directory, get/set environment variable, execute shell command, etc. |
The following existing libraries outside of the Modelica standard library have been improved and added as new libraries (models using the previous libraries are automatically converted to the new sublibraries inside package Modelica):
Modelica.Blocks.Discrete | Discrete input/output blocks with fixed sample period (from ModelicaAdditions.Blocks.Discrete) |
Modelica.Blocks.Logical | Logical components with Boolean input and output signals (from ModelicaAdditions.Blocks.Logical) |
Modelica.Blocks.Nonlinear | Discontinuous or non-differentiable algebraic control blocks such as variable limiter, fixed, variable and Pade delay etc. (from ModelicaAdditions.Blocks.Nonlinear) |
Modelica.Blocks.Routing | Blocks to combine and extract signals, such as multiplexer (from ModelicaAdditions.Blocks.Multiplexer) |
Modelica.Blocks.Tables | One and two-dimensional interpolation in tables. CombiTimeTable is available in Modelica.Blocks.Sources (from ModelicaAdditions.Tables) |
Modelica.Mechanics.MultiBody | Components to model the movement of 3-dimensional mechanical systems. Contains body, joint, force and sensor components, analytic handling of kinematic loops, force elements with mass, series/parallel connection of 3D force elements etc. (from MultiBody 1.0 where the new signal connectors are used; makes the ModelicaAdditions.MultiBody library obsolete) |
As a result, the ModelicaAdditions library is obsolete, because all components are either included in the Modelica library or are replaced by much more powerful libraries (MultiBody, StateGraph).
The following new components have been added to existing libraries.
Modelica.Blocks.Logical. | |
Pre | y = pre(u): Breaks algebraic loops by an infinitesimal small time delay (event iteration continues until u = pre(u)) |
Edge | y = edge(u): Output y is true, if the input u has a rising edge |
FallingEdge | y = edge(not u): Output y is true, if the input u has a falling edge |
Change | y = change(u): Output y is true, if the input u has a rising or falling edge |
GreaterEqual | Output y is true, if input u1 is greater or equal than input u2 |
Less | Output y is true, if input u1 is less than input u2 |
LessEqual | Output y is true, if input u1 is less or equal than input u2 |
Timer | Timer measuring the time from the time instant where the Boolean input became true |
Modelica.Blocks.Math. | |
BooleanToReal | Convert Boolean to Real signal |
BooleanToInteger | Convert Boolean to Integer signal |
RealToBoolean | Convert Real to Boolean signal |
IntegerToBoolean | Convert Integer to Boolean signal |
Modelica.Blocks.Sources. | |
RealExpression | Set output signal to a time varying Real expression |
IntegerExpression | Set output signal to a time varying Integer expression |
BooleanExpression | Set output signal to a time varying Boolean expression |
BooleanTable | Generate a Boolean output signal based on a vector of time instants |
Modelica.Mechanics.MultiBody. | |
Frames.from_T2 | Return orientation object R from transformation matrix T and its derivative der(T) |
Modelica.Mechanics.Rotational. | |
LinearSpeedDependentTorque | Linear dependency of torque versus speed (acts as load torque) |
QuadraticSpeedDependentTorque | Quadratic dependency of torque versus speed (acts as load torque) |
ConstantTorque | Constant torque, not dependent on speed (acts as load torque) |
ConstantSpeed | Constant speed, not dependent on torque (acts as load torque) |
TorqueStep | Constant torque, not dependent on speed (acts as load torque) |
The following bugs have been corrected:
Modelica.Mechanics.MultiBody.Forces. | |
LineForceWithMass Spring |
If mass of the line force or spring component is not zero, the mass was (implicitly) treated as "mass*mass" instead of as "mass" |
Modelica.Mechanics.Rotational. | |
Speed | If parameter exact=false, the filter was wrong (position was filtered and not the speed input signal) |
Other changes:
- All connectors are now smaller in the diagram layer. This gives a nicer layout when connectors and components are used together in a diagram
- Default instance names are defined for all connectors, according to a new annotation introduced in Modelica 2.1. For example, when dragging connector "Flange_a" from the Rotational library to the diagram layer, the default connector instance name is "flange_a" and not "Flange_a1".
- The Modelica.Mechanics.Rotational connectors are changed from a square to a circle
- The Modelica.Mechanics.Translational connectors are changed from a green to a dark green color in order that connection lines can be better seen, especially when printed.
- The Modelica.Blocks connectors for Real signals are changed from blue to dark blue in order to distinguish them from electrical signals.