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 processes
such 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 software
development project.
Thread-Safe Architecture: This library is developed to ensure thread safety, allowing for concurrent access without compromising data integrity through the utilization of immutable objects. The exception 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 the public 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 large
companies and their AI models - at the expense of open-source creators. Given this shift, it became necessary for the
library to transition to a commercial model.
The hvac-engine-pro project will serve as the private version, where all future features and enhancements will be developed. Access to this version will be available within a paid plan. For more information or to discuss licensing details, please feel free to contact 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 specified Fluid 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 the
source code available to the users of that network.
I extend my heartfelt gratitude to the Silesian University of Technology for imparting invaluable knowledge to me.
Badges used in readme: Shields.io and Badges 4 README.md.