Reference ellipsoids for geodesy and geophysics


Boule is Python library for representing reference ellipsoids geometrically, calculating their gravity fields, and performing some global coordinate conversions. “Boule” is also French for “ball” as well as a traditional shape of bread resembling a squashed ball (much like the Earth).

Boule is designed for:

  • Storing and manipulating ellipsoid parameters for spherical harmonic analysis and coordinate system conversions.

  • Calculating normal gravity for generating gravity anomalies and gravity disturbances.

Getting started

New to Boule? Start here!


Need help?

Ask on our community channels.

Join the conversation

Reference documentation

A list of modules and functions.

List of functions and classes (API)

Using Boule for research?

Citations help support our work!

Citing Boule

Boule is ready for use but still changing

This means that we sometimes break backwards compatibility as we try to improve the software based on user experience, new ideas, better design decisions, etc. Please keep that in mind before you update Boule to a newer version.

We welcome feedback and ideas! This is a great time to bring new ideas on how we can improve the project. Join the conversation or submit issues on GitHub.

See also

Boule is a part of the Fatiando a Terra project.