Repository files navigation

Author:Piotr Jazdzyk, MScEng
LinkedIn:https://www.linkedin.com/in/pjazdzyk

HVAC|Engine is a comprehensive library for calculating moist air properties, encompassing crucial thermodynamic processessuch as heating, dry cooling, real cooling with condensate discharge, mixing single or multiple air streams, and more.Our goal is to provide a straightforward and efficient psychrometrics library, ideal for integration into any HVAC softwaredevelopment project.

Thread-Safe Architecture: This library is developed to ensure thread safety, allowing for concurrent access withoutcompromising data integrity through the utilization of immutable objects. Theexception is modular data flow processing model,which components are designed as mutable and stateful. See User Guide, section: 5.

Effective from 10th April 2025, the HVAC-Engine library has been divided into two distinct projects.This repository will continue to serve as thepublic version of the library, which will receive limited maintenance,bug fixes, and updates to dependencies.No new features will be introduced in this version.

The decision to split the project stems from the evolution of AI-driven scraping technology, which benefits largecompanies and their AI models - at the expense of open-source creators. Given this shift, it became necessary for thelibrary to transition to acommercial model.

Thehvac-engine-pro project will serve as theprivate version, where all future features and enhancements willbe developed. Access to this version will be available within a paid plan. For more information or to discuss licensing details,please feel free tocontact me directly.

Copy the Maven dependency provided below to your pom.xml file, and you are ready to go. For other package managers, check maven central repository:HVAC|Engine.

<dependency>    <groupId>com.synerset</groupId>    <artifactId>hvac-engine</artifactId>    <version>2.2.0</version></dependency>

HVAC|Engine is developed using the following technologies:

Core:
     

Engineering:
   

CI/CD:
   

• atmospheric pressure based on height above sea level,
• temperature change based on height above sea level,
• water vapour saturation pressure,
• dew point temperature and wet bulb temperature,
• air relative humidity,
• humidity ratio and maximum humidity ratio,
• kinematic and dynamic viscosity,
• thermal conductivity,
• specific enthalpy of humid air with water mist and ice mist components,
• specific heat,
• density,
• thermal diffusivity,
• Prandtl number.

• specific heat,
• density,
• specific enthalpy.

• mass flow,
• volumetric flow,
• mass flow of dry air component,
• volumetric flow of dry air component,
• based on flow type specified during instance creation, other flows will be recalculated accordingly for specifiedFluid properties,

• heating process for input heat,
• heating process for target outlet air temperature,
• heating process for target outlet air relative humidity,

• dry cooling process for input heat,
• dry cooling process for target outlet air temperature,
• real cooling process with condensate discharge process for input heat,
• real cooling process with condensate discharge process for target outlet temperature,
• real cooling process with condensate discharge process for target outlet relative humidity,

• simple mixing of two flows with humidity content,
• mixing of multiple flows with humidity content,

GNU AGPL 3.0 LICENSE.
This work is licensed under the terms of the GNU Affero General Public License (AGPL) 3.0. You may copy, modify,and distribute this work, provided that you comply with the terms of the AGPL. If you modify and distribute the work,you must provide proper attribution to the original author,Piotr Jazdzyk,in all derivative works and publications. Additionally, if you use the software over a network, you must make thesource code available to the users of that network.

I have provided badges that you can include in your project to showcase your usage of our library:

Small shield with referenced most recent version tag:

[![Hvac-Engine](https://img.shields.io/github/v/release/pjazdzyk/hvac-engine?label=Hvac-Engine&color=13ADF3&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyMi41bW0iIGhlaWdodD0iMTQuNW1tIiB2aWV3Qm94PSIwIDAgMjI1MCAxNDUwIj4NCiAgPHBvbHlnb24gZmlsbD0iIzUwN0QxNCIgcG9pbnRzPSIyMjQxLjAzLDE1Ljg4IDExMzYuMzgsMTUuODQgOTA1Ljg4LDQxNS4xIDIwMTAuNTMsNDE1LjA5IiAvPg0KICA8cG9seWdvbiBmaWxsPSIjNzFBQjIzIiBwb2ludHM9IjExMTYuMzgsMTUuODQgNjU1Ljk5LDE1Ljg0IDQ5NC4xNSwyOTYuMTcgNzI0LjM1LDY5NC44OCIgLz4NCiAgPHBvbHlnb24gZmlsbD0iIzhBQzkzNCIgcG9pbnRzPSI0ODQuMTUsMzA2LjE3IDI1NS4wNiw3MDIuOTYgMzg3LjY2LDkzMi42NCA4NDUuODMsOTMyLjYzIiAvPg0KICA8cG9seWdvbiBmaWxsPSIjNThEMEZGIiBwb2ludHM9Ii03LjE3LDE0NDAuMDkgMTA5Ny45NywxNDQwLjA4IDEzMjguNDcsMTA0MC44MyAyMjMuMzIsMTA0MC44NSIgLz4NCiAgPHBvbHlnb24gZmlsbD0iIzEzQURGMyIgcG9pbnRzPSIxNzM5LjA0LDExNjAuOTEgMTUwOS4wOSw3NjIuNjQgMTExNy45NywxNDQwLjA4IDExODYuOTMsMTQ0MC4wOCAxNTc3Ljg3LDE0NDAuMDgiIC8+DQogIDxwb2x5Z29uIGZpbGw9IiMwMzkzRDAiIHBvaW50cz0iMTk3OC44LDc1Mi45NiAxODQ2LjIsNTIzLjMgMTM4Ni42OCw1MjMuMyAxNzQ5LjA0LDExNTAuOTEiIC8+DQo8L3N2Zz4=)](https://github.com/pjazdzyk/hvac-engine)

Tech shield with version tag for manual adjustment (you can indicate which version you actually use):

[![Hvac-Engine](https://img.shields.io/badge/Hvac_Engine-v2.2.0-13ADF3?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyMi41bW0iIGhlaWdodD0iMTQuNW1tIiB2aWV3Qm94PSIwIDAgMjI1MCAxNDUwIj4NCiAgPHBvbHlnb24gZmlsbD0iIzUwN0QxNCIgcG9pbnRzPSIyMjQxLjAzLDE1Ljg4IDExMzYuMzgsMTUuODQgOTA1Ljg4LDQxNS4xIDIwMTAuNTMsNDE1LjA5IiAvPg0KICA8cG9seWdvbiBmaWxsPSIjNzFBQjIzIiBwb2ludHM9IjExMTYuMzgsMTUuODQgNjU1Ljk5LDE1Ljg0IDQ5NC4xNSwyOTYuMTcgNzI4LjM1LDY5NC44OCIgLz4NCiAgPHBvbHlnb24gZmlsbD0iIzhBQzkzNCIgcG9pbnRzPSI0ODQuMTUsMzA2LjE3IDI1NS4wNiw3MDIuOTYgMzg3LjY2LDkzMi42NCA4NDUuODMsOTMyLjYzIiAvPg0KICA8cG9seWdvbiBmaWxsPSIjNThEMEZGIiBwb2ludHM9Ii03LjE3LDE0NDAuMDkgMTA5Ny45NywxNDQwLjA4IDEzMjguNDcsMTA0MC44MyAyMjMuMzIsMTA0MC44NSIgLz4NCiAgPHBvbHlnb24gZmlsbD0iIzEzQURGMyIgcG9pbnRzPSIxNzM5LjA0LDExNjAuOTEgMTUwOS4wOSw3NjIuNjQgMTExNy45NywxNDQwLjA4IDExODYuOTMsMTQ0MC4wOCAxNTc3Ljg3LDE0NDAuMDgiIC8+DQogIDxwb2x5Z29uIGZpbGw9IiMwMzkzRDAiIHBvaW50cz0iMTk3OC44LDc1Mi45NiAxODQ2LjIsNTIzLjMgMTM4Ni42OCw1MjMuMyAxNzQ5LjA0LDExNTAuOTEiIC8+DQo8L3N2Zz4=)](https://github.com/pjazdzyk/hvac-engine)

In the JavaDoc, you'll find linked references to specific papers and technical literature listed below.

• [1] - ASHRAE FUNDAMENTALS 2002, CHAPTER 6 "Psychrometrics"
• [2] - Buck, Arden L. "New Equations for Computing Vapour Pressure and Enhancement Factor". Journal of AppliedMeteorology and Climatology (December 1981).
• [3] - Buck Research Instruments L.L.C. "MODEL CR-1A HYGROMETER WITH AUTO FILL OPERATING MANUAL" (May 2012).
• [4] - Morvay Z.K, Gvozdenac D.D. "Fundamentals for analysis and calculation of energy and environmental performance".Applied Industrial Energy And Environmental Management.
• [5] - Lipska B. "Projektowanie Wentylacji i Klimatyzacji. Podstawy uzdatniania powietrza" Wydawnictwo PolitechnikiŚląskiej (Gliwice 2014).
• [6] -https://www.engineeringtoolbox.com
• [7] - Stull R. "Wet-Bulb Temperature from Relative Humidity and Air Temperature". Manuscript received 14 July 2011, infinal form 28 August 2011
• [8] - Tsilingiris P.T "Thermophysical and transport properties of humid air at temperature range between 0 and 100oC".Elsevier, Science Direct (September 2007)
• [9] - E.W. Lemmon, R.T. Jacobsen, S.G. Penoncello, D. Friend. Thermodynamic Properties of Air and Mixtures ofNitrogen, Argon, and Oxygen from 60 to 2000 K at Pressures to 2000 MPa. J. Phys. Chem. Ref. Data, Vol. 29, No. 3, (2000)
• [10] - M. Wanielista, R. Kersten, R. Eaglin. "Hydrology Water Quantity and Quality Control. 2nd ed." (1997).
• [11] - F.E. Jones, G.L. Harris. ITS-90 Density of water formulation for volumetric standards' calibration. Journal ofResearch of the National Institute of Standards and Technology (1992)
• [12] - Water specific heat tables:https://www.engineeringtoolbox.com/specific-heat-capacity-water-d_660.html

I extend my heartfelt gratitude to theSilesian University of Technology for imparting invaluable knowledge to me.
Badges used in readme:Shields.io andBadges 4 README.md.