fatiando 0.5
Modeling and inversion for geophysics
License: BSD License
Keywords: geophysics modeling inversion gravimetry seismic magnetometry

.. image:: https://raw.githubusercontent.com/fatiando/logo/master/fatiando-banner-homepage.png
    :alt: Fatiando a Terra
    :target: http://www.fatiando.org

----

**Website and documentation**: `www.fatiando.org <http://www.fatiando.org>`__

**Development documentation**: `www.fatiando.org/dev <http://www.fatiando.org/dev>`__

**Mailing list (get updates and ask for help)**: `groups.google.com/d/forum/fatiando <https://groups.google.com/d/forum/fatiando>`__


.. image:: http://img.shields.io/pypi/v/fatiando.svg?style=flat-square
    :alt: Latest version on PyPI
    :target: https://pypi.python.org/pypi/fatiando/
.. image:: http://img.shields.io/travis/fatiando/fatiando/master.svg?style=flat-square
    :alt: Travis CI build status
    :target: https://travis-ci.org/fatiando/fatiando
.. image:: http://img.shields.io/coveralls/fatiando/fatiando/master.svg?style=flat-square
    :alt: Test coverage status
    :target: https://coveralls.io/r/fatiando/fatiando?branch=master
.. image:: http://img.shields.io/badge/doi-10.5281/zenodo.157746-blue.svg?style=flat-square
    :alt: doi:10.5281/zenodo.157746
    :target: http://dx.doi.org/10.5281/zenodo.157746


Overview
--------

Our goal is provide a comprehensive and extensible framework
for geophysical data analysis and the development of new methodologies.

**Research:**
Make your research more **reproducible** by writing a Python script or Jupyter
notebook instead of clicking through complicated menus.

**Development:**
Don't start from scratch! Build upon the existing tools in Fatiando to develop
new methods.

**Teaching:**
Combine Fatiando with the Jupyter notebook to make rich, interactive documents.
Great for teaching fundamental concepts of geophysics!


Getting started
---------------

1. `Install Fatiando <http://www.fatiando.org/install.html>`__ and its
   dependencies.
2. Browse the `Gallery <http://www.fatiando.org/dev/gallery/index.html>`__ and
   `Cookbook <http://www.fatiando.org/cookbook.html>`__ for examples of what
   Fatiando can do.
3. Take a look at the `Documentation <http://www.fatiando.org/docs.html>`__ for
   a detailed reference of the library.
4. Get involved in the development through our `Developer Guide
   <http://www.fatiando.org/develop.html>`__.


Participating and asking for help
---------------------------------

**Subscribe** to our Google Groups mailing list to stay informed and ask for
help:
`groups.google.com/d/forum/fatiando <https://groups.google.com/d/forum/fatiando>`__

We'll post updates to the list about new releases and features, events, and
future plans for the project.
**Get involved** to help us shape the project and make it even better!

Another option for reaching out and reporting bugs is to
`open an issue on Github <https://github.com/fatiando/fatiando/issues>`__.

We have an **open development** process where everything is discussed through
`Github issues <https://github.com/fatiando/fatiando/issues>`__. Anyone can
comment and give feedback. See our `Roadmap for v1.0
<https://github.com/fatiando/fatiando/issues/102>`__ to get a feeling for where
the project is headed. **Your input is welcome!**


Citing
------

If you use it in your research, please cite Fatiando in your publications as:

    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.

Please **also cite the method papers** of individual functions/classes.
References are available in the documentation of each module.

See the `CITATION.rst
<https://github.com/fatiando/fatiando/blob/master/CITATION.rst>`__ file or the
`Citing section <http://www.fatiando.org/cite.html>`__ of the docs for more
information.


License
-------

Fatiando a Terra is free software: you can redistribute it and/or modify it
under the terms of the **BSD 3-clause License**. A copy of this license is
provided in `LICENSE.txt`.