What’s new?

v1.5.0 – XXXXXXXXXX XXXXXXXXXX (Jun XX, 2026)

New Features

  • heatpumps’ dashboard now has english and german language modes

  • Other languages can be added easily due to modular translation structure

  • The dashboard can export models as JSON, which can be used to initialize a model class in python or a plain TESPy model

  • heatpumps now supports air-source heat pumps

Improvements

  • The model classes are adjusted to work with TESPy >= v0.10

    • Make use of PowerConnection cpmponents

    • Use exerpy for exergy analysis

    • Save stable values as dicts in memory instead of cached files

    • Simulations can be faster

  • Add more flexibility for plotting labels (axes, title, legends)

  • Some instruction text was updated

  • Add documentation for from_json method

  • Reduced code duplication

Fixes

  • Fix the few failing heat pump setups (improved parameters and init_simulation)

Contributors

Full changelog: v1.4.1…v1.5.0

v1.4.1 – Planetary Publication (Jun 16, 2026)

Fixes

  • Correcting T_mid calculation in initial and final design simulation to align with offdesign simulation

  • Reseting topology reduction specification when offdesign simulation fails

Contributors

Full changelog: v1.4.0…v1.4.1

v1.4.0 – Planetary Publication (May 12, 2026)

New Features

Improvements

  • Avoiding code duplication thanks to the HeatPumpCascadeBase class

  • Centralizing the offdesign simulation routine

  • Improving consistency checks

  • Using importlib and platformdirs for interaction with the file system

  • Minor imporvements of the dashboard GUI

  • Update streamlit version

  • Add Carnot and Lorenz COP calculation

Fixes

  • Correcting some input files to work out of the box

  • Correcting some unit tests

Contributors

Full changelog: v1.3.0…v1.4.0

v1.3.0 – Pacy Portrayal (Jul 15, 2024)

New Features

  • Fast reload of precalculated state diagram isolines

  • New refrigerant CO2 (R744)

Improvements

  • Improved state diagrams

  • Better and more robust handling of errors and missing data during state diagram creation

  • Extended usage example

Fixes

  • Total and specific investment cost calculation was missing the multiplication factor. Previous results where too low by a factor of 6.32

  • Heat sink feed flow temperature was limited below the refrigerants critical temperature. This makes no sense for transcritical heat pumps and was therefore changed for those heat pump setups. Hence, this update is necessary for usage of transcritical heat pumps through the dashboard. The models themselves were not limited and are therefore not affected by this flaw.

  • Fix some topology schemas that where missing labels

Contributors

Full changelog: v1.2.0…v1.3.0

v1.2.0 – Cool Cascading (Jun 28, 2024)

New Features

  • Existing stock of heat pump models was widely extended by two-cycle cascade heat pump model versions.

Tests

  • Basic framework for automated tests of models was created using pytest.

Contributors

Full changelog: v1.1.2…v1.3.0

v1.1.2 – Stability Regained (Jun 21, 2024)

  • This version is a patch for v1.1.0 and v1.1.1, as the update of the underlying TESPy version introduced some instabilities at high heat sink return flow temperatures.

Contributors

Full changelog: v1.1.1…v1.1.2

v1.1.1 – Hotfix for v1.1.0 (Jun 19, 2024)

  • Hotfix for v1.1.0 TESPy Update. Heat pump model class HeatPumpFlash was left out in upgrading for TESPy v0.7.x and is fixed in this release.

Contributors

Full changelog: v1.1.0…v1.1.1

v1.1.0 – TESPy Update (Jun 19, 2024)

  • All heat pump models are updated to work with the latest TESPy version 0.7.5.

  • Furthermore, an API is added to easily get the default parameter files of a specific heat pump model class.

Contributors

Full changelog: v1.0.0…v1.1.0

v1.0.0 – Initial Release (Jun 18, 2024)

  • Initial release of the heatpumps package.

  • It contains a comprehensive library of heat pump model classes, as well as a powerful dashboard to visualize, simulate and analyze them.

Contributors