Repository with a Vapor Compression Library in Python for steady state process design and simulation. It enables use of RefProp and CoolProp as well as different compressors, heat exchangers and flowsheet configurations for heat pumps and chillers.
To install, run
pip install vclibpy
To use RefProp, you have to buy the licence and obtain a valid .dll file.
In order to help development, install it as an egg:
git clone https://github.com/RWTH-EBC/vclibpy
pip install -e vclibpy
We recommend running our jupyter-notebook to be guided through a helpful tutorial.
For this, we prepared several examples, which we encourage to check one by one.
To use, you can either run the code locally or in a browser using juypter-notebook:
If the web-hosting is not available, you can run the notebooks locally with the following code:
pip install jupyter
git clone https://github.com/RWTH-EBC/vclibpy
jupyter notebook vclibpy/docs/jupyter_notebooks
Or, clone this repo and look at the folder examples.
Those examples are the same as the jupyter notebooks.
VCLibPy is currently in the process of publication.
Until the paper is published, you may cite the following DOI: https://doi.org/10.5281/zenodo.14202185
Moreoever, the following list of related publications show VCLibPy in use.
- Vering, C., Wüllhorst, F., Mehrfeld, P., & Müller, D. (2021). Towards an integrated design of heat pump systems: Application of process intensification using two-stage optimization. Energy Conversion and Management, 250, 114888. https://doi.org/10.1016/j.enconman.2021.114888
- Vering, Christian; Müller, Dirk (Thesis advisor); Elbel, Stefan (Thesis advisor) (2023). Optimal design of heat pump systems for existing buildings, PhD thesis. https://doi.org/10.18154/RWTH-2023-04070
Visit our official Documentation.
Please raise an issue here.
We gratefully acknowledge the financial support by the Federal Ministry for Economic Affairs and Climate Action (BMWK), promotional reference 03EN1022B, as well as the European Regional Development Fund (ERDF) (ERDF-0500029).
