Package: hplib
hplib - heat pump libraryRepository with code tobuild adatabasewith relevant data from public Heatpump Keymark Datasets.identifyefficiency parametersfrom the database with a least-square regression model, comparable to Schwamberger [1].simulateheat 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 aspecific manufacturer + modelor alternatively for one of6 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, Kai Rösken. (2021). RE-Lab-Projects/hplib: heat pump library (v1.8). Zenodo.https://doi.org/10.5281/zenodo.5521597DocumentationIf you're interested in how the database and parameters were calclulated, have a look into the DocumentationHTMLorJupyter-Notebook. There you also find asimulation examplesand avalidation.Heat pump models and Group IDsThe hplib_database.csv contains the following number of heat pump models, sorted by Group ID[Group ID]: CountReglulatedOn-OffOutdoor Air / Water[1]: 366[4]: 23Brine / Water[2]: 54[5]: 53Water / Water[3]: 0[6]: 10DatabaseAll resulting database CSV file are under.The following columns are available for every heat pump of this libraryColumnDescriptionCommentManufacturerName of the manufacturer30 manufacturersModelName of the heat pump model506 modelsDateheat pump certification date2016-07-27 to 2021-03-10TypeType of heat pump modelOutdoor Air/Water, Brine/Water,  Water/WaterSubtypeSubtype of heat pump modelOn-Off, RegulatedGroup IDID for combination of type and subtype1 - 6RefrigerantRefrigerant TypeR134a, R290, R32, R407c, R410a, otherMass of Refrigerant [kg]Mass of Refrigerant0.15 to 14.5 kgSPL indoor [dBA]Sound emissions indoor15 - 68 dBASPL outdoor [dBA]Sound emissions outdoor33 - 78 dBAPSB [W]Eletrical power consumption, standby mode3 to 60 WClimateClimate definition for set points, which were used for parameter identificationaverage, colder, warmerP_el_h_ref [W]Electrical power at -7°C / 52°C881 to 23293 WP_th_h_ref [W]Thermal heating power at -7°C / 52°C2400 to 69880 Wp1-p4_P_thFit-Parameters for thermal power-p1-p4_P_elFit-Parameters for electricl powerP_el = P_el_ref * (p1 * T_in + p2 * T_out + p3 + p4 * T_amb)p1-p4_COPFit-Parameters for COPCOP = p1 * T_in + p2 * T_out + p3 + p4 * T_ambp1-p4_EERFit-Parameters for EEREER = p1 * T_in + p2 * T_out + p3 + p4 * T_ambMAPE_P_elmean absolute percentage error for electrical input power (simulation vs. measurement)average over all heat pump models = 16,3 %MAPE_COPmean absolute percentage error for thermal input power (simulation vs. measurement)average over all heat pump models = 9,8 %MAPE_P_thmean absolute percentage error for coefficient of performance (simulation vs. measurement)average over all heat pump models = 19,7 %UsageGet repository with pip:pip install hplibor:Download or clone repository:git clone https://github.com/RE-Lab-Projects/hplib.gitCreate the environment:conda env create --name hplib --file requirements.txtCreate some code withfrom hplib import hpliband use the included functionshplib.load_database(),hplib.get_parameters,hplib.same_built_type(),hplib.HeatPump,hplib.HeatPump.simulate,hplib.HeatingSystem.calc_brine_temp()andhplib.HeatingSystem.calc_heating_dist_temp()Hint:The csv files in theoutputfolder are for documentation and validation purpose. The code and database files, which are meant to be used for simulations, are located in thehplibfolder.Input-DataThe 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 fromhttps://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.Further development & possibilities to collaborateIf 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.