analemma 0.4.1

<style> .center { display: block; margin-left: auto; margin-right: auto; } .quote-text { text-align: center; margin: 0 auto; font-size: 1.5em; } .source-text{ text-align: right; margin-right: 10%; font-size: 0.9em; } </style>

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/analemma
Issue Tracker	https://github.com/russellgoyder/analemma/issues
Discussions	https://github.com/russellgoyder/analemma/discussions
Changelog	https://analemma.readthedocs.io/en/stable/changelog

Resources

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.

Reference Article

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 are in the analemma repository.

Jupyter Notebooks

You can view and run Jupyter notebooks which reproduce all derivations and calculations in the article using symbolic algebra.

• Sundial geometry and analemma derivation
• Example plots of the analemma
• The Equation of Time
• Orbits

I used geometric algebra for this work and have a cheat sheet which could you useful if you familiar with the topic.

Presentations

I presented this work in part 1 and part 2 of a metauni seminar.

Building the LaTeX source

To build, run latexmk -pdf in docs/paper. 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.

© Russell Goyder