# PsychroLib
[](https://github.com/psychrometrics/psychrolib/actions/workflows/ci.yml) [](https://pypi.org/project/PsychroLib) [](https://www.nuget.org/packages/PsychroLib) [](https://cran.r-project.org/package=psychrolib) [](https://doi.org/10.21105/joss.01137) [](https://doi.org/10.5281/zenodo.2537945)
[Overview](#overview) | [Documentation](#documentation) | [Installation](#installation) | [How to cite](#how-to-cite) | [Contributing](#contributing) | [Development](#development) | [Copyright and license](#copyright-and-license) | [Acknowledgements](#acknowledgements)
Overview
PsychroLib is a software library to enable the calculation of psychrometric properties of moist and dry air. Versions of PsychroLib are available for Python, C, C#, Fortran, R, JavaScript, Microsoft Excel Visual Basic for Applications (VBA). PsychroLib works in both metric (SI) and imperial (IP) systems of units. For a general overview and a list of currently available functions, please see the overview page.
Documentation
Please see the Python API documentation for the common API across all the supported language implementations. In Python, array support and improved runtime performance can be optionally enabled by installing Numba. In R (1) constants, like ZERO_FAHRENHEIT_AS_RANKINE are not exported (i.e. not directly accessible to users), (2) functions accept a vector, not a scalar (3) bulk calculations, like CalcPsychrometricsFromRelHum return a list.
Examples on how to use PsychroLib in all the supported languages are described in this guide.
Installation
- Python: from the Python Package Index (PyPI). Numba can be optionally installed to enable array support and faster runtime performance.
- C# (.NET): from the NuGet package manager or clone the repository, and bundle according to your requirements.
- C, Fortran and JavaScript: clone the repository, and bundle according to your requirements.
- VBA/Excel: download the ready-made spreadsheets from the release tab.
- R: from the Comprehensive R Archive Network (CRAN).
How to cite
When using PsychroLib, please cite the software summary paper and software version using the following Digital Object Identifiers (DOIs) to generate citations in your preferred style:
| Software summary paper | Software version* |
|---|---|
 |
 |
*please make sure to cite the same version you are using with the correct DOI. For a list of all available versions see see more on Zenodo.
Contributing
If you are looking to contribute, please read our Contributors' guide for details.
Development
If you would like to know more about specific development guidelines and testing, please refer to our development notes.
Copyright and license
Copyright 2018-2020 The PsychroLib Contributors for the current library implementation.
Copyright 2017 ASHRAE Handbook — Fundamentals (https://www.ashrae.org) for equations and coefficients published ASHRAE Handbook — Fundamentals Chapter 1.
Software licensed under the MIT License.
Acknowledgements
Special thanks to:
- @tom-- for his suggestions with the original JavaScript library implementation
- @DJGosnell for the C# port.
- @hongyuanjia and @banfelder for the R port.
For the full list of contributors, please see the contributors page.