|
Size: 1573
Comment:
|
← Revision 22 as of 2015-08-17 01:55:30 ⇥
Size: 1876
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
| Line 7: | Line 6: |
| [[http://tetrasys.homelinux.org/cgi-bin/viewvc.cgi/sunrisesunset/|CVS Repository]] This is off site. | [[http://tetrasys.homelinux.org/cgi-bin/viewvc.cgi/sunrisesunset/?root=cvs|CVS Repository]] This is off site. |
| Line 9: | Line 8: |
| [[http:/wiki-htdocs/external/SunriseSunset/index.html|API Docs]] | [[http:/wiki-htdocs/external/SunriseSunset/api/index.html|API Docs]] |
| Line 11: | Line 10: |
| [[http://tetrasys-design.net/download/SunriseSunset/sunrisesunset.tar.gz|Download Tarball]] | [[http://tetrasys-design.net/download/SunriseSunset/sunrisesunset-1.0.1.tar.gz|Download Tarball]] [[http://freshmeat.net/projects/sunrise-sunset|Freshmeat Page]] |
| Line 18: | Line 19: |
| Line 26: | Line 26: |
The {{{isNight()}}} method returns {{{True}}} if it is nighttime and {{{False}}} if it is daytime. |
The {{{isNight()}}} method returns {{{True}}} if it is nighttime and {{{False}}} if it is daytime. The optional {{{collar}}} keyword argument if changed will skew the results to either before or after the real sunrise and sunset. This is useful if lead and lag times are needed around the actual sunrise and sunset. |
| Line 30: | Line 29: |
| isNight = ss.isNight() | isNight = ss.isNight(collar=0) |
| Line 32: | Line 31: |
The formula was taked from a VBScript implementation which is broken for certain times of the day. It can be found at: |
The formula was taken from a VBScript implementation which is broken for certain times of the day. It can be found at: |
Sunrise Sunset
This class will determine the sunrise and sunset. It can use either official, civil, nautical, amateur, or astronomical zenith.
CVS Repository This is off site.
The constructor takes three positional arguments and one keyword argument. The date argument is a datetime object with timezone info, lat and lon are floating point values, and zenith is a string consisting of any of the above bold values--the default is official.
ss = SunriseSunset(date, lat, lon, zenith='official')
There are two callable methods after the class is instantiated.
The getSunRiseSet() method returns a tuple of datetime objects with timezome info.
rise, set = ss.getSunRiseSet()
The isNight() method returns True if it is nighttime and False if it is daytime. The optional collar keyword argument if changed will skew the results to either before or after the real sunrise and sunset. This is useful if lead and lag times are needed around the actual sunrise and sunset.
isNight = ss.isNight(collar=0)
The formula was taken from a VBScript implementation which is broken for certain times of the day. It can be found at:
I also found valuable information on these sites:
http://stjarnhimlen.se/english.html