Skip to main content

Accurate solar system data for everyone

Project description

Cerridwen provides geocentric planetary data that is suitable for a broad spectrum of astronomical and astrological applications, with a focus on our solar system. Among its data you will find, for example, the time of the next sunrise or that of the last full moon, or simply the current tropical position of the sun.

The motivation for this package is to have a reliable open-source library and API that provides comprehensive data on various planetary bodies and factors at a certain point in time.

Cerridwen comes with a simple command-line utility and a JSON server, but is also designed to serve as a basis for your own application.


  • Get comprehensive data on the sun and moon at almost any point in time

  • Rely on the high precision of the NASA JPL ephemeris

  • Make use of a powerful numpy-based algorithm for planetary event finding, (e.g. full moon, squares of planets etc.)

  • Work with Julian and ISO dates

  • Use Cerridwen’s JSON API to ensure loose coupling

  • Extend Cerridwen with ease to suit your own needs


Cerridwen’s full documentation can be found at


Cerridwen includes a basic test suite for its calculations and API.

At this time the API is reasonably stable but may change without warning. Please let me know when you need better API stability for your project.

Also, you can check out the status of the current development version at Travis CI:

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cerridwen-1.4.1.tar.gz (37.0 MB view hashes)

Uploaded source

Built Distribution

cerridwen-1.4.1-py3-none-any.whl (24.6 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page