SolarCalculations

This is a collection of solar angle and related calculations.

Source

These are based mostly on Chapter 6 of Heating, Ventilation, and Air Conditioning by Faye McQuistion and Jerald Parker, 3rd Edition, 1988, with minor pieces from other versions of the same book. Other sources are noted in the source. All the functions were written from scratch by me.

Releases

The latest release can be found on the Releases page. All packages are distributed through PyPi.

Documentation

Documentation is hosted on ReadTheDocs. The functions are all documented with Markdown syntax doc strings in a way that Sphinx can interpret them. To build the documentation, enter the docs/ subdirectory and execute make html; then open /docs/_build/html/index.html to see the documentation.

Testing

The source is tested using the python unittest framework. To execute all the unit tests, just execute coverage run -m pytest. The tests are run on each commit by GitHub Actions, and coverage results are pushed to Coveralls. The goal is to be as close to 100% coverage as possible.

Validation

The code has been carefully compared against numerous sampled points in the unit tests, and also against EnergyPlus output, to ensure accurate values are being calculated. If you find something wrong, just file an issue!

Demonstration

In order to show how to use the library, a demonstration page was created, that is based on the source in the demos folder.