Modelica Standard Library

Free library from the Modelica Association to model mechanical (1D/3D), electrical (analog, digital, machines), thermal, fluid, control systems and hierarchical state machines. Also numerical functions and functions for strings, files and streams are included.

Library description

Package Modelica is a free library that is developed together with the Modelica language from the Modelica Association. It is also called Modelica Standard Library. It provides model components and standard component interfaces from many engineering domains. Each model comes with documentation included. The generous license conditions allow usage in commercial products.

Note, the usage of a Modelica library requires a Modelica simulation environment, see the tools page, and that such an environment usually already includes the Modelica standard library. It is possible that the demo version of the commercial tools will not allow to simulate non-trivial examples from the library.

Current release

Download Modelica Standard Library v3.2.2 (2016-04-03)

Release notes

• Version v3.2.2 (2016-04-03)
  • Summary:
    • Version 3.2.2 is backward compatible to version 3.2.1, that is models developed with versions 3.0, 3.0.1, 3.1, 3.2, or 3.2.1 will work without any changes also with version 3.2.2 (with exception of the, usually uncritical, non-backwards compatible changes listed below with regards to external object libraries, and one bug fix introduced in 3.2.1 Build.3 for non-circular pipes that can be non-backwards compatible if a user constructed a new pipe model based on Modelica.Fluid.Pipes.BaseClasses.WallFriction.PartialWallFriction, see details below).
  • Short Overview:
    • This version of the Modelica package is compatible to Modelica Specification 3.2 revision 2
    • About 240 tickets have been fixed in this release and the previous maintenance releases:
      • Version 3.2.1 Build.3 (July 30, 2015) with respect to 3.2.1 Build.2 (August 14, 2013):
      • About 103 tickets have been fixed for this maintenance release.
      • Version 3.2.1 Build.4 (September 30, 2015) with respect to 3.2.1 Build.3 (July 30, 2015):
        • 10 tickets have been fixed for this release. In particular the following critical bug has been fixed:
          • Ticket 1768 fixes an issue with block CombiTimeTable(wrong output when using fixed time step integrator with time step greater than table resolution).
          • Ticket 1758 states that simulation of Modelica.Fluid.Examples.HeatingSystem fails in Dymola 2016 if option "pedantic mode for checking Modelica semantics" is set. This issue was not fixed in the library.
          • In ticket 1757 it is (correctly) stated that the example model PsychrometricData was moved to another location and that this is a non-backwards compatible change. This non-backwards compatible change is accepted, because it fixes a circular depedency (a model references a package in which it resides), for details see ticket 1679. Fixing this ticket is seen as of much higher priority, as the small drawback that an example model is moved (and the probability is very high that this moved model is not used in any user model).
      • Version 3.2.2 Build.2 (March 16, 2016) with respect to 3.2.1 Build.4 (September 30, 2015):
        • About 130 tickets have been fixed for this release.
        • The ModelicaStandardTables object library (.lib, .dll, .a, .so, depending on tool) has been split into the libraries ModelicaStandardTables, ModelicaMatIO, zlib and the new object library ModelicaIO has been added. For a tool vendor this can be a non-backwards compatible change if the same object libraries have been used in the past for different releases of package Modelica. In Resources/C-sources/_readme.txt the issue is explained in detail and how to resolve it. For a user this might be a non-backwards compatible change if he/she implemented an own external C interface function to one of the functions in the ModelicaStandardTables, ModelicaMatIO or zlib libraries. In this case, the library annotations to these functions need to be adapted.
    • In version 3.2.1+build.3 a new argument crossArea was introduced in the functions of Modelica.Fluid.Pipes.BaseClasses.WallFriction.PartialWallFriction to fix a subtle bug for the calculation of pipe friction for non-circular pipes, see #1601 and #1656. If a user utilized a pipe model of Modelica.Fluid.Pipes, this does not matter because the pipe models have been improved in a fully backwards compatible way. However, if the user constructed an own pipe model based on the partial package PartialWallFriction and calls the functions defined in PartialWallFriction with positional (and not named) arguments, then a unit warning or error will occur (depending on the tool and tool-specific settings) because the new argument crossArea has unit [m2] and the previous argument at this place, roughness, has unit [m]. If the warning is ignored, the simulation result will be wrong, because the crossArea is used as roughness. The user needs to fix this by adapting his/her pipe model so that the crossArea is used in the function calls, or by using named function arguments.
  • Detailed Release Notes
• Version v3.2.1 (2013-08-14)
  • Summary: Version 3.2.1 (Build 2) is backward compatible to version 3.2, that is models developed with versions 3.0, 3.0.1, 3.1, or 3.2 will work without any changes also with version 3.2.1. This is a "clean-up" with major emphasis on quality improvement and tool compatibility. The goal is that all Modelica tools will support this package and will interpret it in the same way. This version of the Modelica package is fully compatible to Modelica Specification 3.2 Revision 2. 60 models and blocks and 90 functions were newly included.
  • Detailed Release Notes
• Version v3.2 (2010-10-25)
  • Summary: Version 3.2 (Build 5) is the new major release of the Modelica Standard Library. About 360 new models/blocks and 300 new functions are added, including 7 new sublibraries
  • Detailed Release Notes
• Version v3.1 (2009-08-14)
  • Summary: Version 3.1 is slightly based on the Modelica Specification 3.1.
  • Detailed Release Notes
• Version v3.0.1 (2009-01-27)
  • Summary: Slightly improved version of the Modelica Standard Library 3.0 (several new components added, existing components improved, bugs corrected, backward compatible).
  • Detailed Release Notes
• Version v3.0 (2008-03-01)
  • Summary: Version 3.0 is not backward compatible to previous versions. A conversion script is provided to transform models and libraries of previous versions to the new version.
  • Detailed Release Notes
• Version v2.2.2 (2007-08-31)
  • Summary: Version 2.2.2 is backward compatible to version 2.2.1 and 2.2 with the following exceptions:
    • Removal of package Modelica.Media.Interfaces.PartialTwoPhaseMediumWithCache (this was not yet utilized).
    • Removal of the media packages in Modelica.Media.IdealGases.SingleGases that are not type compatible to Modelica.Media.Interfaces.PartialMedium, because a FluidConstants record definition is missing.
  • Detailed Release Notes
• Version v2.2.1 (2006-03-24)
  • Summary: Version 2.2.1 is backward compatible to version 2.2. In this version, no new libraries have been added.
  • Detailed Release Notes
• Version v2.2 (2005-04-06)
  • Summary: Version 2.2 is backward compatible to version 2.1. Two new packages have been added, Modelica.Media and Modelica.Thermal.FluidHeatFlow.
  • Detailed Release Notes
• Version v2.1 (2004-11-11)
  • Summary: 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.
  • Detailed Release Notes
• Version v1.6 (2004-06-21)
  • Summary: Added 1 new library (Electrical.MultiPhase), 17 new components, improved 3 existing components in the Modelica.Electrical library and improved 3 types in the Modelica.SIunits library.
  • Detailed Release Notes

License

This Modelica package is free software and the use is completely at your own risk; it can be redistributed and/or modified under the terms of the Modelica License 2.

Development and contribution

The devolopment is organised by the Modelica Association.

You may report any issues by using the Modelica Issue Tracker.