broham / suncalcpy

A python implementation of the SunCalc javascript library.

SunCalcPy

A Python library for calculating sun/moon times, positions and phases. Includes methods for getting:

• sunrise
• sunset
• moonrise
• moonset
• golden hour
• sun position
• moon position
• moon illumination
• and more!

Installing

pip install suncalcPy

Usage examples:

Get sunrise, sunset, golden hour and other times for San Francisco:

>>> import suncalc
>>> suncalc.getTimes(datetime.now(), 37.7749, -122.4194)
{
   'sunriseEnd': '2017-09-06 06:48:24', 
   'goldenHourEnd': '2017-09-06 07:20:27', 
   'dusk': '2017-09-06 19:59:44', 
   'nightEnd': '2017-09-06 05:15:09', 
   'night': '2017-09-06 21:03:39', 
   'goldenHour': '2017-09-06 18:58:21', 
   'sunset': '2017-09-06 19:33:08', 
   'nauticalDawn': '2017-09-06 05:47:35', 
   'sunsetStart': '2017-09-06 19:30:24', 
   'dawn': '2017-09-06 06:19:04', 
   'nauticalDusk': '2017-09-06 20:31:13', 
   'sunrise': '2017-09-06 06:45:40'
}

Get moon illumination information:

>>> import suncalc
>>> suncalc.getMoonIllumination(datetime.now())
{
   'phase': 0.5198419002220316, 
   'angle': 1.574687975565145, 
   'fraction': 0.9961193570459752
}

Get moonrise/moonset times for San Francisco:

>>> import suncalc
>>> suncalc.getMoonTimes(datetime.now(), 37.7749, -122.4194)
{
   'rise': datetime.datetime(2017, 9, 6, 20, 4, 29, 213367), 
   'set': datetime.datetime(2017, 9, 6, 6, 56, 30, 536332)
}