Sundials, Orbits and the Analemma
They deciphered my analemma!
- Fraa Orolo in Anathem by Neal Stephenson (2008)
The analemma is the beautiful double-loop path traced by the shadow on a sundial (or the sun in the sky) when observed at the same time each day throughout one year. This package calculates and plots the analemma for all types of sundial anywhere on earth, or any planet.
pip install analemma
PyPI | https://pypi.org/project/analemma/ |
Documentation | https://analemma.readthedocs.io/en/stable/ |
Source | https://github.com/russellgoyder/sundial |
Issue Tracker | https://github.com/russellgoyder/sundial/issues |
Discussions | https://github.com/russellgoyder/sundial/discussions |
The analemma
package implements the mathematics of sundial and orbits for an arbitrary sundial geometry and orientation placed anywhere on any planet. The analemma expressed in an exact parametric expression which reduces to standard results for the special cases of common dial types. Despite sundials being thousands of years old, I cannot find an expression for the analemma quite as general as this in the literature.
The analemma is derived from first principles in The sundial problem from a new angle - Russell Goyder.pdf - the latest version of a paper originally published in the European Journal of Physics in 2006. The LaTeX source and figures for the paper is in the sundial-latex repository.
You can view and run Jupyter notebooks which reproduce all derivations and calculations in the article using symbolic algebra.
I used geometric algebra for this work and have a cheat sheet which could you useful if you familiar with the topic.
I presented this work in part 1 and part 2 of a metauni seminar.
To build, run latexmk -pdf
. To clean up, latexmk -C
and if you want, find figs -name 'figure?.eps-converted-to.pdf' | xargs rm
. Note - fixed a typo in figure 3 (DialFrame.fig) using inkscape which couldn’t save as fig, so I saved it as DialFrame.svg.
This work is licensed under a Creative Commons Attribution 4.0 International License.