Repository with code to
- build a database with relevant data from public Heatpump Keymark Datasets.
- identify efficiency parameters from the database with a least-square regression model, comparable to Schwamberger [1].
- simulate heat pump efficiency (COP) as well as electrical (P_el) & thermal power (P_th) and massflow (m_dot) as time series.
For the simulation, it is possible to calculate outputs of a specific manufacturer + model or alternatively for one of 6 different generic heat pump types.
[1] K. Schwamberger: „Modellbildung und Regelung von Gebäudeheizungsanlagen mit Wärmepumpen“, VDI Verlag, Düsseldorf, Fortschrittsberichte VDI Reihe 6 Nr. 263, 1991.
For reference purposes:
- DOI:
- Citation: Tjarko Tjaden, Hauke Hoops. (2021). RE-Lab-Projects/hplib: heat pump library (v1.2). Zenodo. https://doi.org/10.5281/zenodo.5553195
If you're interested in how the database and parameters were calclulated, have a look into the Documentation HTML or Jupyter-Notebook. There you also find a simulation examples and a validation.
Download or clone repository:
git clone https://github.com/RE-Lab-Projects/hplib.git
Create the environment:
conda env create --name hplib --file requirements.txt
Create some code with import hplib
and use the included functions hplib.load_database()
, hplib.get_parameters
and hplib.simulate
.
Hint: The csv files in the output
folder are for documentation and validation purpose. The code and database files, which are meant to be used for simulations, are located in the src
folder.
The hplib_database.csv contains the following number of heat pump models, sorted by Group ID
[Group ID]: Count | Reglulated | On-Off |
---|---|---|
Outdoor Air / Water | [1]: 366 | [4]: 23 |
Brine / Water | [2]: 54 | [5]: 53 |
Water / Water | [3]: 0 | [6]: 10 |
All resulting database CSV file are under .
The following columns are available for every heat pump of this library
Column | Description | Comment |
---|---|---|
Manufacturer | Name of the manufacturer | 30 manufacturers |
Model | Name of the heat pump model | 506 models |
Date | heat pump certification date | 2016-07-27 to 2021-03-10 |
Type | Type of heat pump model | Outdoor Air/Water, Brine/Water, Water/Water |
Subtype | Subtype of heat pump model | On-Off, Regulated |
Group ID | ID for combination of type and subtype | 1 - 6 |
Refrigerant | Refrigerant Type | R134a, R290, R32, R407c, R410a, other |
Mass of Refrigerant [kg] | Mass of Refrigerant | 0.15 to 14.5 kg |
SPL indoor [dBA] | Sound emissions indoor | 15 - 68 dBA |
SPL outdoor [dBA] | Sound emissions outdoor | 33 - 78 dBA |
PSB [W] | Eletrical power consumption, standby mode | 3 to 60 W |
Climate | Climate definition for set points, which were used for parameter identification | average, colder, warmer |
P_el_ref [W] | Electrical power at -7°C / 52°C | 881 to 23293 W |
P_th_ref [W] | Thermal power at -7°C / 52°C | 2400 to 69880 W |
p1-p4_P_th | Fit-Parameters for thermal power | - |
p1-p4_P_el | Fit-Parameters for electricl power | P_el = P_el_ref * (p1 * T_in + p2 * T_out + p3 + p4 * T_amb) |
p1-p4_COP | Fit-Parameters for COP | COP = p1 * T_in + p2 * T_out + p3 + p4 * T_amb |
MAPE_P_el | mean absolute percentage error for electrical input power (simulation vs. measurement) | average over all heat pump models = 16,3 % |
MAPE_COP | mean absolute percentage error for thermal input power (simulation vs. measurement) | average over all heat pump models = 9,8 % |
MAPE_P_th | mean absolute percentage error for coefficient of performance (simulation vs. measurement) | average over all heat pump models = 19,7 % |
The European Heat Pump Association (EHPA) hosts a website with the results of laboratory measurements from the keymark certification process. For every heat pump model a pdf file can be downloaded from https://keymark.eu/en/products/heatpumps/certified-products.
This repository is based on all pdf files that were download for every manufacturer on 2021-03-12.
- Extend hplib.py and hplib_database.csv for cooling functionality
- Make hplib installable via
pip
If you find errors or are interested in developing together on the heat pump library, please create an ISSUE and/or FORK this repository and create a PULL REQUEST.