Predicting Local Circumstances of Solar Eclipses

Predict local circumstances (UTC and topocentric coordinates) of solar eclipses.
1.1K Downloads
Updated 20 Dec 2024

View License

This submission is a MATLAB script named solar_eclipse that can be used to predict local circumstances of solar eclipses. This computer program provides the universal times and topocentric coordinates of the Sun and Moon at the beginning and end of the penumbra contacts, and the time and coordinates at maximum eclipse. The source ephemeris for this routine is a JPL binary ephemeris file.
This application uses several functions ported to MATLAB from the Fortran version of the NOVAS (Naval Observatory Vector Astrometry Subroutines) source code developed at the United States Naval Observatory. Information about the NOVAS software suite can be found at https://aa.usno.navy.mil/software/novas_info.
The solar_eclipse MATLAB script also uses routines from the MICE software suite to read and evaluate the DE430 ephemeris data. Ephemeris files, platform dependent versions of the MICE mex file and other useful MATLAB functions are available at naif.jpl.nasa.gov/naif/toolkit_MATLAB.html. MICE is a MATLAB implementation of the SPICE library created by JPL.
This script uses a combination of one-dimensional minimization and root-finding to solve this classical astronomy problem. The objective function used in these calculations is the difference between the selenocentric (Moon-centered) separation angle between the axis of the lunar shadow and an Earth observer, and the penumbra shadow angle.

Cite As

David Eagle (2025). Predicting Local Circumstances of Solar Eclipses (https://www.mathworks.com/matlabcentral/fileexchange/39358-predicting-local-circumstances-of-solar-eclipses), MATLAB Central File Exchange. Retrieved .

MATLAB Release Compatibility
Created with R2024b
Compatible with any release
Platform Compatibility
Windows macOS Linux
Categories
Find more on Gravitation, Cosmology & Astrophysics in Help Center and MATLAB Answers

Community Treasure Hunt

Find the treasures in MATLAB Central and discover how the community can help you!

Start Hunting!
Version Published Release Notes
1.5.0.0

Updated several MATLAB functions and PDF documentation.

1.4.0.0

Added missing seclprt.m MATLAB function. Thanks to Christie H. for the catch.

1.3.0.0

Updated to use JPL DE440s ephemeris (included with zip file) and MICE/NOVAS routines

1.2.0.0

Added display of local circumstances during the total/annular phase of a solar eclipse. Included solar eclipse documentation from Volume 2 Number 2 of Celestial Computing.

1.1.0.0

Added MICE version of this script in the solar_eclipse_mice.zip archive.

1.0.0.0