This page reflects the development version (master branch on Github). Go to fatiando.org for the latest release.

Disclaimer

Fatiando is under active development and we are still changing the API between releases. Names will change and functions will move as we improve our design. You might have to update your scripts and notebooks to get the latest features.
Please bear with us.

Overview

Gravity and magnetics

Modeling, inversion, and processing for potential field methods.

3D forward modeling with prisms, polygonal prisms, spheres, and tesseroids. Handles the potential, acceleration, gradient tensor, magnetic induction, total field magnetic anomaly.

Seismology and seismics

Simple modeling functions for seismics and seismology.

Toy problems for: Cartesian straight-ray tomography, VSP, epicenter estimation. Experimental finite-difference wave propagation.

Grid generation and manipulation

Functions for generating and operating on regular grids and data that is on a map.

Generate regular grids and point scatters. Cut grids and extract profiles. Interpolate irregular data.

Geometric objects and meshes

Classes that represent geometric objects (points, prisms, polygons, tesseroids) and meshes (regular prism mesh, points on a grid).

Standard classes used in all of Fatiando. Efficient classes for meshes that save storage and behave as iterators.

Datasets and I/O

Experiment with our packaged test datasets or load your data with some of our functions for input and output.

Test gravity and magnetic data, load data from Surfer ASCII grids, generate data and models from images.

Inverse problems

Build your own inversions by implementing the bare minimum. We provide standard regularization and optimization.

Classes for least-squares problems, Tikhonov regularization, gradient-descent optimization, and more.

Get started

See the install instructions to set up your computer and install Fatiando.

Once you have everything installed, take a look at the Documentation for a detailed tour of the library. You can also browse the Gallery and Cookbook for examples of what Fatiando can do.

Want more inspiration? Check out how Fatiando is being used in the Use cases page.

Stay informed: Sign up to our mailing list to keep up-to-date with new releases and events and give your feedback.

Get help

There are many ways to contact us:

If you come across a bug, please include in your message: your operating system, Python version, Fatiando version, code that generated the error, the full error message.

Contribute

Feedback: Send us your bug reports, feature requests, spelling corrections, usage examples, etc. We love to hear what the community thinks!

Documentation: We need a lot of help improving our documentation. You can report typos, suggest new sections and improvements, and anything that you think would make the docs better in any way.

Code: If you want to get involved with the code, take a look at our Developer Guide. All source code development is done in the open on the Github repository fatiando/fatiando. A good place to start is with our curated list of low-hanging fruit.

If you want to help but are not sure how, ask on the Gitter chat room and we’ll help you get started. Don’t be afraid to ask for help!

Support

Fatiando is research software made by scientists. Your citations help us justify the effort that goes into building and maintaining Fatiando.

TL;DR: If you just want to copy and paste something, include the following in your Methods or Acknowledgments:

The results presented here were obtained with the help of the open-source software Fatiando a Terra by Uieda et al. (2013).

and the reference:

Uieda, L., V. C. Oliveira Jr, and V. C. F. Barbosa (2013), Modeling the Earth with Fatiando a Terra, Proceedings of the 12th Python in Science Conference, pp. 91 - 98.

See Citing for more details on how to cite Fatiando in your publications.

Watch

Watch an introduction to what Fatiando is all about in this presentation from Scipy 2013.