The DLR Thermofluid Stream Library is a free open-source library for the robust modeling of complex thermofluid architectures. Designed to be easy to use and easy to adapt and enriched by a number of examples, this library can be used as basis for many different applications such as thermal management of electric cars, power plants, or building physics.
30.04.2026: Release of TFS 1.3.0 (Minor Release); Release 1.3.0 Highlights
- Updated dependencies to Modelica Standard Library 4.1.0 and Complex 4.1.0.
- Added new
CentrifugalPumpmodel with characteristic-based parameterization and test models. - Added
StaticHeadandTankCuboidcomponents. - Improved OpenModelica/OMEdit compatibility, especially for
CentrifugalPumpandSingleSensorSelect. - Improved pressure-drop visualization for
FlowResistanceand valve components. - Extended incompressible media with additional thermodynamic properties.
- Improved moist-air media functions, including
isentropicExponentandspecificEntropy. - Fixed Reynolds-number calculation in
dp_tau_centrifugal. - Improved NTU heat exchanger documentation and simplified
PartialNTU. - Added and updated Dymola and Modelon Impact metadata.
- Winner of the 2021 Modelica Library Award (1st prize) at the International Modelica Conference
- Robust modeling of even complex architectures due to new computational scheme
- Easy to initialize and good support for switching bypasses and other configuration changes
- Many examples that enable an easy start to working with this library.
- Many base components that are easy to read, understand and to adapt to your own needs
- Support for systems that reverse their flow direction such as combined heat-pump/vapour cycle
- Support for discretized heat exchangers
The DLR ThermoFluid Stream Library uses a innovative computational scheme that has been developed for the object-oriented formulation of even complex system architectures. Key is the decomposition of pressure into a steady-flow component and an inertial component driving the balance of mass-flows. Using this decomposition all non-linear equations can be brought into explicit form and what remains to be solved is a purely linear equation system.
Watch the introductory video from the 2021 Modelica Conference and read the corresponding paper in MDPI electronics (short version):
The principal considerations for creating a solution for non-directed flows (or bidirectionality) is presented in:
- Zimmer, D., N. Weber, M. Meissner (2021) Robust Simulation of Stream-Dominated Thermo-Fluid Systems: From Directed to Non-Directed Flows. Simulation Notes Europe, Volume 31(4):177-184
- Zimmer, Dirk, Michael Meißner, Niels Weber (2021) The DLR ThermoFluidStream Library. 14th International Modelica Conference, Linköping, Sweden.
- Zimmer, Dirk (2019a). Robust Simulation of StreamDominated Thermo-Fluid Systems: From Unidirectional to Bidirectional Applications. EUROSIM Congress (Logrono, Spain).
More details on the modeling of various types of volumes can be found in:
- M. Meissner, Zimmer, D. (2022) Robust Modeling of Volumes for Dynamic Simulations of Thermo-Fluid Stream Networks. IFAC Papers Online Volume 55 Issue 20.
Further background literature on the methodology:
- Zimmer, Dirk, Michael Meißner, Niels Weber (2022). The DLR ThermoFluid Stream Library. Electronics, Volume 11(22), 3790.
- Zimmer, Dirk (2020). Robust object-oriented formulation of directed thermofluid stream networks. Mathematical and Computer Modelling of Dynamical Systems, Volume 26(3), pp. 204–233.
- Zimmer, Dirk, Daniel Bender, Alexander Pollok (2018). Robust Modeling of Directed Thermofluid Flows in Complex Networks. Proceedings of the 2nd Japanese Modelica Conference, Tokyo, Japan.
- Zimmer, Dirk (2019b). Towards hard real-time simulation of complex fluid networks. Proceedings of the 13th International Modelica Conference, Regensburg, Germany. Linköping University Electronic Press, Linköpings universitet, pp. 579–587.
- Otter, M. et al. (2019). Thermodynamic Property and Fluid Modeling with Modern Programming Language Constructs. Proceedings of the 13th International Modelica Conference, Regensburg, Germany. Linköping University Electronic Press, Linköpings universitet.
- Dymola: The library has been developed using Dymola and is based on Modelica Standard Library 4.1.0. Pedantic checking has been applied to improve cross-tool compatibility.
- Open Modelica: To a large extent, the library is compatible to Open Modelica. Details in Issue 10. Use an OpenModelica version that supports Modelica Standard Library 4.1.0.
- Modelon Impact: The library is reported to be fully compatible to Modelon Impact. Details in Issue 19.
The library is provided by DLR Institute of System Architectures in Aeronautics and the DLR Institute of Robotics and Mechatronics.
Individual authors of these organizations are:
- Niels Weber (@nieweber)
- Tobias Reischl (@tobiasreischl)
- Corentin Lepais (@CorentinLepais)
- Raphael Gebhart (@RaphaelGebhart)
- Silvan Keim (@SilvanKeim)
- Niclas Dotzauer (@Nicsda)
- Dirk Zimmer (@dzimmer)
We are very grateful to @IngelaLind from Saab Aeronautics, Linköping, Sweden for all models regarding static head pressure as well as media models for liquid and gas mixtures.
We want to express our gratitude to Peter Stein and Philipp Jordan from HTWG Konstanz for their pipe models based on Idelchik.
We would like to thank very much @wischhusen from XRG Simulation GmbH for additional open-source Media models such as R1234yf.
- Michael Meißner (@mimeissner)
This work has been partially supported by the Helmholtz Gemeinschaft in frame of the research project for on-board diagnosis. Hence we would also like to thank the team of Robert Bosch GmbH for feedback and motivating use-case scenarios. Further thanks goes to Christopher Laughman from Mitsubishi Electronic Research Center for providing initial feedback. Also the work of Tobias Krenz from TU Darmstadt was providing motivating use cases of the new approach. We are still grateful to Airbus and our former colleagues Dr Alexander Pollok and Dr. Daniel Bender who were pioneering the new methodology. Also we like to thank our colleague Dr. Peter Eschenbacher for his valuable modeling experience on valves and pumps. We would like to thank the Open Modelica Team for their support regarding tool compatibility.
The used continuous integration stuff originates in parts from that used in the development of the Modelica Standard Library. We would like to thank MAP-Lib project members who established this CI for their valuable work.
At the 16th International Modelica Conference 2025, a tutorial is held about modeling of complex architectures using the library. The modeling templates can be downloaded here: ThermoFluidStreamTutorial.zip (Version 2023: TFS_Tutorial.zip)