# 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 [](http://solar-calculations.readthedocs.org/en/latest/)
Documentation is hosted on [ReadTheDocs](http://solar-calculations.readthedocs.org/en/latest/). 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 [](https://travis-ci.org/Myoldmopar/SolarCalculations)
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](https://travis-ci.org/Myoldmopar/SolarCalculations).
## Validation
The code has been carefully compared against numerous sampled points in the unit tests, and also [against EnergyPlus output](https://github.com/Myoldmopar/SolarCalculations/wiki/CompareToEnergyPlus), to ensure accurate values are being calculated. If you find something wrong, just [file an issue](https://github.com/Myoldmopar/SolarCalculations/issues/new)!
## Demonstration
In order to show how to use the library, a [demonstration page](https://github.com/Myoldmopar/SolarCalculations/wiki/DemoSolarAngles) was created, that is based on the source in the demos/ folder.
Raw data
{
"_id": null,
"home_page": "https://github.com/Myoldmopar/SolarCalculations",
"name": "solar-angles",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "Solar Angles, Building Simulation, Whole Building Energy Simulation, Heat Transfer, Modeling",
"author": "Edwin Lee",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/7b/d4/f7611aa27c6cd750857c3582873ad84a9b7ead08cc6bd3503bac246579fd/solar_angles-0.25.tar.gz",
"platform": "Linux (Tested on Ubuntu)",
"description": "# SolarCalculations\nThis is a collection of solar angle and related calculations.\n \n## Source\nThese 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.\n\n## Documentation [](http://solar-calculations.readthedocs.org/en/latest/)\nDocumentation is hosted on [ReadTheDocs](http://solar-calculations.readthedocs.org/en/latest/). 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.\n\n## Testing [](https://travis-ci.org/Myoldmopar/SolarCalculations)\nThe 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](https://travis-ci.org/Myoldmopar/SolarCalculations).\n\n## Validation\nThe code has been carefully compared against numerous sampled points in the unit tests, and also [against EnergyPlus output](https://github.com/Myoldmopar/SolarCalculations/wiki/CompareToEnergyPlus), to ensure accurate values are being calculated. If you find something wrong, just [file an issue](https://github.com/Myoldmopar/SolarCalculations/issues/new)!\n\n## Demonstration\nIn order to show how to use the library, a [demonstration page](https://github.com/Myoldmopar/SolarCalculations/wiki/DemoSolarAngles) was created, that is based on the source in the demos/ folder.\n",
"bugtrack_url": null,
"license": "ModifiedBSD",
"summary": "Quick solar_angles angle calculation package",
"version": "0.25",
"project_urls": {
"Homepage": "https://github.com/Myoldmopar/SolarCalculations"
},
"split_keywords": [
"solar angles",
" building simulation",
" whole building energy simulation",
" heat transfer",
" modeling"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "d3d71623f15fdad98fb03ba658041dcc43ea4d0dfa421dc4dff97bb077d9a582",
"md5": "c7f89824fafdef1fe563c5274dcb7039",
"sha256": "dc90ba2d6de5d160a24affb911d104617961d155fabf6fa7a696c05555c6fda1"
},
"downloads": -1,
"filename": "solar_angles-0.25-py3-none-any.whl",
"has_sig": false,
"md5_digest": "c7f89824fafdef1fe563c5274dcb7039",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 6968,
"upload_time": "2024-07-30T13:34:41",
"upload_time_iso_8601": "2024-07-30T13:34:41.587894Z",
"url": "https://files.pythonhosted.org/packages/d3/d7/1623f15fdad98fb03ba658041dcc43ea4d0dfa421dc4dff97bb077d9a582/solar_angles-0.25-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7bd4f7611aa27c6cd750857c3582873ad84a9b7ead08cc6bd3503bac246579fd",
"md5": "bdc845224b64586515bde9832c7125a9",
"sha256": "48da661205549e61458cc11f399c83791c750e4ff73eab71ef688517e021fd2c"
},
"downloads": -1,
"filename": "solar_angles-0.25.tar.gz",
"has_sig": false,
"md5_digest": "bdc845224b64586515bde9832c7125a9",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 7647,
"upload_time": "2024-07-30T13:34:42",
"upload_time_iso_8601": "2024-07-30T13:34:42.494895Z",
"url": "https://files.pythonhosted.org/packages/7b/d4/f7611aa27c6cd750857c3582873ad84a9b7ead08cc6bd3503bac246579fd/solar_angles-0.25.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-07-30 13:34:42",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Myoldmopar",
"github_project": "SolarCalculations",
"travis_ci": false,
"coveralls": true,
"github_actions": true,
"requirements": [
{
"name": "matplotlib",
"specs": []
},
{
"name": "pytest",
"specs": []
},
{
"name": "coverage",
"specs": []
},
{
"name": "coveralls",
"specs": []
},
{
"name": "flake8",
"specs": []
},
{
"name": "sphinx",
"specs": []
},
{
"name": "wheel",
"specs": []
},
{
"name": "setuptools",
"specs": []
}
],
"lcname": "solar-angles"
}
JSON
