The DLR Thermofluid Stream Library

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.

Status

News

Tutorial at the Modelica Conference 2025

We will give a tutorial on Modeling complex thermal architectures using the DLR ThermoFluid Stream Library at the Modelica Conference 2025 Luzern. The Tutorial Abstract Booklet is now available.

We look forward to meeting you there and sharing ideas.

Highlights

• 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

Technical Background

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):

License, Terms of Use, Literature

Likewise to Modelica Library of the Modelica Standard Library, the DLR Thermodluid Stream Library is published under the 3-Clause BSD License.

If you publish work that is based on this library, please cite the following two papers.

``` @article{TFS2022, author = {Zimmer, Dirk and Meiner, Michael and Weber, Niels}, title = {The DLR ThermoFluid Stream Library}, journal = {Electronics}, volume = {11}, year = {2022}, number = {22}, doi = {10.3390/electronics11223790}, URL = {https://www.mdpi.com/2079-9292/11/22/3790}, ISSN = {2079-9292} }

@article{RobustZimmer2020, author = {Dirk Zimmer}, title = {Robust object-oriented formulation of directed thermofluid stream networks}, journal = {Mathematical and Computer Modelling of Dynamical Systems}, volume = {26}, number = {3}, pages = {204-233}, year = {2020}, publisher = {Taylor & Francis}, doi = {10.1080/13873954.2020.1757726}, URL = {https://doi.org/10.1080/13873954.2020.1757726} }

```

We also welcome feedback in form of issues raised here on GitHub. Also when you have positive feedback, you can feel free to raise an issue to share your experience. Have fun!

Further literature: 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 Meiner, Niels Weber (2021) The DLR ThermoFluidStream Library. 14th International Modelica Conference, Linkping, 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, 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). Linkping University Electronic Press, Linkpings universitet, pp. 579587.
• Otter, M. et al. (2019). Thermodynamic Property and Fluid Modeling with Modern Programming Language Constructs. Proceedings of the 13th International Modelica Conference (Regensburg, Germany). Linkping University Electronic Press, Linkpings universitet.

Tool compatibility

• Dymola: The library has been developed using Dymola and is based on Modelica 3.2.3. Pedantic checking has been applied to all components in order to improve cross-tool compatibility.
• Open Modelica: To a large extent, the library is compatible to Open Modelica. Details in Issue 10:
• Modelon Impact: The library is reported to be fully compatible to Modelon Impact. Details in Issue 19.

Authors and Contributors

The Library is provided by the DLR Institute of System Dynamics and Control.

Deutsches Zentrum fr Luft- und Raumfahrt, Institut fr Systemdynamik und Regelungstechnik, Mnchener Strasse 20, 82234 Wessling-Oberpfaffenhofen, Germany

Individual authors of this organization are: - @dzimmer - @RaphaelGebhart - @nieweber

Further Notable Contributions

We are very grateful to @IngelaLind from Saab Aeronautics, Linkping, 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.

Alumni

• @mimeissner

Acknowledgements

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 Chistopher Laughman from Mitsubishi Electronic Research Center for providing initial feedback. Also the work of Tobias Krenz form 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.

Tutorial

At the 15th International Modelica Conference 2023, a tutorial is held about modeling of complex architectures using the library. The modeling templates can be downloaded here: TFS_Tutorial.zip