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.

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 Meißner, 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

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.

Tool compatibility

• Dymola: The library has been developed using Dymola and is based on Modelica 3.2.3. Pendantic 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 für Luft- und Raumfahrt, Institut für Systemdynamik und Regelungstechnik, Münchener Strasse 20, 82234 Wessling-Oberpfaffenhofen, Germany

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

Further Notable Contributions

We would like to thank very much Stefan Wischhusen from XRG Simulation GmbH for additional open-source Media models such as R1234yf: - @wischhusen

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.