Skip to content

The DLR Thermofluid Stream Library

License

Notifications You must be signed in to change notification settings

modelica-3rdparty/ThermofluidStream

 
 

Repository files navigation

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

GitHub release GitHub license GitHub workflow Modelica Library Award 2021

News

Thank you all for participating at the TFS Community Event! It is great to have new contributors on board and we were very happy to meet our users and see so many applications.

Final program and presentations are now available.

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

IMAGE ALT TEXT HERE

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

More details on the modeling of various types of volumes can be found in:

Further background literature on the methodology:

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

Further Notable Contributions

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.

Alumni

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

Packages

No packages published

Languages

  • Modelica 87.2%
  • Motoko 12.6%
  • Python 0.2%