.. title:: Home

.. raw:: html

    <h1 class="display-2 text-center">
      Ensaio
    </h1>

.. raw:: html

    <p class="centered lead front-page-callout">
      Practice datasets to probe your code
    </p>
    <img class="front-page-banner" src="_static/banner.png" alt="A sampling of our datasets">

**Ensaio** (Portuguese for "rehearsal") is a Python package for downloading
open-access sample datasets for Geoscience.
It taps into the curated collection of `Fatiando a Terra Datasets
<https://github.com/fatiando-data>`__ that is designed for use in tutorials,
documentation, and teaching.

.. panels::
    :header: text-center text-large
    :card: border-1 m-1 text-center

    **Getting started**
    ^^^^^^^^^^^^^^^^^^^

    New to Ensaio? Start here!

    .. link-button:: using
        :type: ref
        :text: Downloading data
        :classes: btn-outline-primary btn-block stretched-link

    ---

    **Need help?**
    ^^^^^^^^^^^^^^

    Ask on our community channels

    .. link-button:: https://www.fatiando.org/contact
        :type: url
        :text: Join the conversation
        :classes: btn-outline-primary btn-block stretched-link

    ---

    **Browse our datasets**
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^

    Take a look at what's available

    .. link-button:: gallery
        :type: ref
        :text: Gallery
        :classes: btn-outline-primary btn-block stretched-link

    ---

    **Reference documentation**
    ^^^^^^^^^^^^^^^^^^^^^^^^^^^

    A list of modules and functions

    .. link-button:: api
        :type: ref
        :text: API reference
        :classes: btn-outline-primary btn-block stretched-link

.. seealso::

    Ensaio is a part of the
    `Fatiando a Terra <https://www.fatiando.org/>`_ project.


----


Table of contents
-----------------

.. toctree::
    :caption: User Guide
    :maxdepth: 1

    install.rst
    tutorial/using.rst
    tutorial/developers.rst
    gallery/index.rst

.. toctree::
    :caption: Reference
    :maxdepth: 1

    api/index.rst
    compatibility.rst
    changes.rst
    versions.rst

.. toctree::
    :caption: Community

    Join the community <https://www.fatiando.org/contact/>
    Code of Conduct <https://github.com/fatiando/community/blob/main/CODE_OF_CONDUCT.md>
    How to contribute <https://github.com/fatiando/ensaio/blob/main/CONTRIBUTING.md>
    Source code on GitHub <https://github.com/fatiando/ensaio>
    Authors <https://github.com/fatiando/ensaio/blob/main/AUTHORS.md>
    Fatiando a Terra <https://www.fatiando.org>