Skip to main content

Total Solar Eclipses, Visualized and Animated

This is a guest post by Christopher Clark, creator of - Sarah

Later this summer, on August 21, the 70 mile wide shadow of the Moon will race across the continental United States at over 1,500 miles per hour. The sun’s elusive, spectacular corona will be visible in twelve states coast to coast for a few fleeting minutes as the total solar eclipse unfolds throughout the day.

It’s been a long time coming. The last time any of the lower 48 states had such an opportunity was 38 years ago. This is the first real chance for many of us, having lived in America all of our lives, to see one of the most rare and eerie celestial events our planet has to offer.

As a long time astronomy enthusiast, I was originally drawn to Cesium several years ago when beginning the planning process for seeing this eclipse firsthand. That led to the development of, an open source Cesium-powered site for visualizing and exploring solar eclipse events.

I originally wrote on the Cesium blog about the launch of back in March of 2015, the day before that year’s only solar eclipse would sneak across the Arctic. Since then it’s been a pleasure to iterate on the project. Eclipse events spanning over 100 years, past and future, have now been added using NASA eclipse data. The improvements in core Cesium (between 1.4 in 2015 and 1.35 today) have dramatically improved performance when jumping around eclipse events in space… and time.

It’s actually the time dimension of solar eclipses that makes Cesium such a perfect tool for visualizing them. Total solar eclipses are pretty rare–typically only one or two occur in a given year. But the swaths of Earth touched by the umbral (complete) shadow of the moon are thin ribbons, and the Earth is a pretty big place. To have one of those ribbons come within a few hundred miles of one’s home is something that may only happen once or twice in a lifetime.

Here’s how those ribbons of shadow last touched the contiguous United States (and only just) back in 1970 and 1979.

​But it’s not just the time in history that makes total solar eclipses so elusive, it’s the time of day. The Moon’s umbral shadow is relatively small (about twice the size of New Jersey at its biggest) and moves at over twice the speed of sound. To catch it, and to be close to its center line for the longest time beneath it (a few minutes), takes determination and ingenuity.

Cesium excels at providing tight time controls to dial in the timing of solar eclipse totality at arbitrarily precise locations. The Animation and Timeline widgets, along with pan and zoom controls, makes for a very effective 4-dimensional exploration tool.


As anyone who has chased eclipses knows, exploration and planning up front is critical! If you’re interested in visiting a spot along the center line for the August 21 total solar eclipse then here are some tips to help ensure you get the best possible viewing experience:

  • Be mobile. If clouds move in it will still get dark but you’ll miss the spectacular show above! Keep watch of local weather radar and be prepared to move quickly.
  • Know your escape routes. If your preferred area isn’t going to work out and you need to move then the last thing you’ll want is a traffic jam when the clock’s ticking. Expect crowds and plan to avoid them. Study back roads that hug the center line of the path of totality and know when the shadow arrives in case you need to get around some big obstacles.
  • Have eclipse glasses! They look like the old-time 3D movie glasses. The cheapest paper ones (at about $1 each) are perfect because you can have several on hand to share with less prepared folks around you. The solar filter material lenses allow for looking directly at the sun in any conditions (those with good eyes can even make out sun spots while wearing them). This is a vital tool for watching the sun as the moon slowly swallows it up over the course of an hour or so in advance of totality, as well as protecting your eyes for when the totality ends but you’re still looking up.

If you’re interested in contributing to, the full project and source code is at The project also makes use of the Python CZML library (project and source code at, which is also always welcoming to collaborators.

Now let’s go chase some shadows!