.. _cite:

Citing
======

Fatiando is **made by scientists**.  Citations help us justify the effort that
goes into building and maintaining Fatiando.

Citing the software
-------------------

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.

This article was `peer-reviewed
<https://github.com/scipy-conference/scipy_proceedings/pull/52>`__ and is
available open-access at the `conference website
<http://conference.scipy.org/proceedings/scipy2013/uieda.html>`__.
Source files and extra material for the paper are on the
`leouieda/scipy2013 <https://github.com/leouieda/scipy2013>`__ Github
repository.

Here is a Bibtex entry for LaTeX users::

    @InProceedings{ uieda-proc-scipy-2013,
      author    = { Leonardo Uieda and Vanderlei C. Oliveira Jr and Val\'eria C. F. Barbosa },
      title     = { Modeling the Earth with Fatiando a Terra },
      booktitle = { Proceedings of the 12th Python in Science Conference },
      pages     = { 96 - 103 },
      year      = { 2013 },
      editor    = { St\'efan van der Walt and Jarrod Millman and Katy Huff }
    }


Citing the methods
------------------

Please also cite the method papers of individual functions and classes. The
proper references are found in the function, class or module documentation.

For example,  the ``fatiando.gravmag.eqlayer.PELGravity`` and
``fatiando.gravmag.eqlayer.PELTotalField`` classes implement:

    Oliveira Jr, V. C., V. C. F. Barbosa, and L. Uieda (2013), Polynomial
    equivalent layer, Geophysics, 78(1), G1-G13, doi:10.1190/geo2012-0196.1.


DOIs for specific versions of Fatiando
--------------------------------------

The source code for each release of Fatiando is archived on
`Zenodo <https://zenodo.org/>`__ and assigned a DOI.
The links below provide citation information if you want to refer to a specific
release.
However, please also **cite the publication** above.

* v0.5 - doi:`10.5281/zenodo.157746 <https://doi.org/10.5281/zenodo.157746>`__
* v0.4 - doi:`10.5281/zenodo.49087 <https://doi.org/10.5281/zenodo.49087>`__
* v0.3 - doi:`10.5281/zenodo.16205 <https://doi.org/10.5281/zenodo.16205>`__
* v0.2 - doi:`10.6084/m9.figshare.1115194 <https://doi.org/10.6084/m9.figshare.1115194>`__
* v0.1 - doi:`10.5281/zenodo.16207 <https://doi.org/10.5281/zenodo.16207>`__