Metadata-Version: 2.0
Name: pyephem-sunpath
Version: 0.2.1
Summary: Calculate sunpath using pyephem
Home-page: https://github.com/santoshphilip/pyephem_sunpath
Author: Santosh Philip
Author-email: santosh_philip@notemail.com
License: GNU General Public License v3
Keywords: pyephem_sunpath
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Requires-Dist: pyephem (>=3.7.6.0)

===============
pyephem_sunpath
===============


.. image:: https://img.shields.io/pypi/v/pyephem_sunpath.svg
        :target: https://pypi.python.org/pypi/pyephem_sunpath

.. image:: https://img.shields.io/travis/santoshphilip/pyephem_sunpath.svg
        :target: https://travis-ci.org/santoshphilip/pyephem_sunpath

.. image:: https://readthedocs.org/projects/pyephem-sunpath/badge/?version=latest
        :target: https://pyephem-sunpath.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status


.. image:: https://pyup.io/repos/github/santoshphilip/pyephem_sunpath/shield.svg
     :target: https://pyup.io/repos/github/santoshphilip/pyephem_sunpath/
     :alt: Updates



Calculate sunpath using pyephem


* Free software: GNU Lesser Public License v3
* Documentation: https://pyephem-sunpath.readthedocs.io.
* Repository: https://github.com/santoshphilip/pyephem_sunpath

Introduction
------------

**Pyephem_sunpath** is built upon pyephem_ an astronomical computation package. From the pyephem_ website we have:

    "**PyEphem** provides basic astronomical computations for the Python programming language. Given a date and location on the Earth’s surface, it can compute the positions of the Sun and Moon, of the planets and their moons, and of any asteroids, comets, or earth satellites whose orbital elements the user can provide. Additional functions are provided to compute the angular separation between two objects in the sky, to determine the constellation in which an object lies, and to find the times at which an object rises, transits, and sets on a particular day."

Pyephem_sunpath uses the a small part of pyephem to calculate the sun position and sun path for any location on earth. The big advantage of using pyephem, is that we will get a high degree of accuracy in the calculations.

Features
--------

- **sunpos()** calculates sun position (in altitude and azimuth) using local time and timezone
- **sunpos_radiance** and **sunpos_radiancexyz** also calculate the sun position. The arguments and results are designed for users of the `Radiance Software <https://www.radiance-online.org>`_.
- function details are in the module documentation and docstrings

Usage
-----

Find the sun position in New Delhi at 1pm::

    from pyephem_sunpath.sunpath import sunpos
    from datetime import datetime

    thetime = datetime(2018, 5, 23, 13)
    lat = 28.6
    lon = 77.2
    tz = 5.5

    alt, azm = sunpos(thetime, lat, lon, tz, dst=False)
    print(alt, azm)

    >> 77.5362391561 232.336370505



Credits
-------

Pyephem_sunpath is built upon pyephem_ an awesome astronomical package

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _pyephem: http://rhodesmill.org/pyephem/index.html
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.2.1 (2018-05-29)
------------------

2018-05-28
----------

* removed click from setup.py

0.2.0 (2018-05-28)
------------------

2018-05-28
~~~~~~~~~~

* cleaned up code
* comprehensive docstrings
* updated README.rst
* added copyright notices
* updated contributing authors

0.1.1 (2018-05-26)
------------------

* Working release on PyPI.

0.1.0 (2018-05-05)
------------------

* First release on PyPI.


