solar-angles 0.2

Quick solar_angles angle calculation package

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.

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 the test file (since it calls unittest.main()): python test/test_solar.py. The tests are also executed by Travis CI.

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.