# Welcome to Tesseroids!ΒΆ

Forward modeling of gravitational fields in spherical coordinates

*Tesseroids* is a collection of **command-line programs**
for modeling the gravitational potential, acceleration, and gradient tensor.

For more information visit the official site.

The geometric element used in the modeling processes is
a **spherical prism**, also called a **tesseroid**.
*Tesseroids* also contains programs for modeling using
**right rectangular prisms**,
both in **Cartesian** and **spherical coordinates**.

*Tesseroids* is developed by Leonardo Uieda
in cooperation with Carla Braitenberg.

If you use *Tesseroids* in your research,
please consider **citing** it in your publications.
See *Citation* for more information.

As of version 1.1,
*Tesseroids* is available under the **BSD license**.
This means that it can be reused and remixed
with fewer restrictions.
See the *license text* for more information.

The **source code** of *Tesseroids* is hosted on GitHub.
There you can browse the code,
create your own fork,
and start contributing!
Get in touch to see how you can help.

This **documentation** explains how to
*install*
and *use* Tesseroids.
It also contains some *theoretical background*
to get you up-to-date with the terms and equations that we use.
The *cookbook* has a few example recipes and the expected output
(I recommend starting here if you just want a quick peek).

- License
- Citation
- Changelog
- Installation instructions
- Theorerical background
- Using Tesseroids
- A note about heights and units
- Getting help information
- Computing the gravitational effect of a tesseroid
- The -a flag
- Verbose and logging to files
- Comments and provenance information
- Generating regular grids
- Automatic model generation
- Calculating the total mass of a model
- Computing the effect of rectangular prisms in Cartesian coordinates
- Piping

- Cookbook
- Calculate the gravity gradient tensor from a DEM
- Simple prism model in Cartesian coordinates
- Simple tesseroid model
- Convert a tesseroid model to prisms and calculate in spherical coordinates
- Convert a tesseroid model to prisms and calculate in Cartesian coordinates
- Using tesslayers to make a tesseroid model of a stack of layers