Solar Position Calculator & Almanac

Warning message

The Propeller Object Exchange system is decommissioned and replaced with a GitHub repository to house the same existing and future Propeller objects. As of 12/5/2019, this site is read-only. You can continue to browse and download objects from here for a limited time; however, please begin using the Parallax Propeller repository for future reference.
By: created: 2011-11-25 | updated: 2013-05-02

The solar object calculates a good approximation of the position (altitude and azimuth) and approximate intensity of the sun at any time (local clock or solar) during the day as well as events such as solar noon, sunrise, sunset, twilight(astronomical, nautical, civil), and day length. Derived values such as the equation of time, time meridians, hour angle, day of the year, air mass and declination are also provided. The calculations may also complement sensor based solar tracking by estimating locations during cloudy or semi-shaded conditions or to track to the starting point at sunrise or to set limits of travel based upon angles. This can help optimise movement frequency or reduce errors due to sensor "hunting". The outputs can be used by two axis (azimuth, altitude) or one axis (declination, hour angle) tracking systems. The code can also calculate the altitude and azimuth for a mirror (heliostat) to reflect the sun to a southern target.

The inputs include date, local/solar time,latitude,longitude and daylight savings time status. Adjustments are made for value local time zones, daylight savings time, leap year, seasonal tilt of the earth, retrograde of earth rotation, and ecliptic earth orbit (Perihelion, Aphelion) and atmospheric refraction.

"Demo" programs uses the object and 2 servos to (a) provide real time coordinates for aiming a solar collector, (b) aim a heliostat reflector mirror at a target, (c) trace the path over a day, (d) calculate almanac data for a day and (e) scribe a noon time analemma. The almanac which does not use servos is ideal for learning about solar, floating point math and the propeller chip.

Please note: The code is heavily documented and is purposely less compact than possible to be easy to use and allow the user to follow and/or modify the formulas and code. Be sure to check the referenced papers and websites for more equations help. Then feel free to make it more efficient/accurate for your use.

For C Programmers: The attached file contains a higher accuracy (+/- 0.0003 degrees) C++ code from NREL that will also run on the Propeller with GCC. However, the XMMC memory model with an SD Card must be used due to the code size. It will take about a minute to run with SPI Flash RAM or about three to four minutes without.


Original File Upload
Package icon solarobject_1.zip98.58 KB
Package icon Auxiliary Files.zip3.34 MB


Contains occurences of passing integer values to Float32 functions (see: Refraction and Equation_Of_Time2 methods for examples.)

Produces a division by zero error at approximately  90 degrees of azimuth (see: Azimuth_Calc method.)

Overall, it works as well as it does probably because the errors contribute only small inaccuracies to the overall output.  It is usable as a place to start, but be prepared to verify virtually everything.

Upper case, lower case and capitalization of symbols is inconsistent. (I know spin does not care, but a consistent style improves readability and comprehension.)

I have not examined nor tested all of the code, having only worked through most of those areas which are of interest to me at this time.

I apologize  for the critical nature of these comments, but they are in fact accurate and might assist someone else attempting to use this code.