.. _tutorials:

Tutorials
=========

This page contains a few tutorials for using PyleoTUPS.

Getting Started
"""""""""""""""

.. grid:: 4
   :gutter: 2
   :margin: 2

   .. grid-item-card::
      :img-top: _static/thumbs/01_a_Data.png
      :link: https://linked.earth/pyleotupsTutorials/a-dataset/
      :link-type: url
      :text-align: left

      **Data, Dataset, Data Repository, Database**
      Provides an overview of the vocabulary used in the tutorials

   .. grid-item-card::
      :img-top: _static/thumbs/01_b_repo.png
      :link: https://linked.earth/pyleotupsTutorials/b-dataprovider/
      :link-type: url
      :text-align: left

      **Paleoclimate Data Repositories:**
      Provides an overview of the two main repositories supported by PyleoTUPS.

   .. grid-item-card::
      :img-top: _static/thumbs/01_c_interface.png
      :link: https://linked.earth/pyleotupsTutorials/c-pyleotupsdesign/
      :link-type: url
      :text-align: left

      **PyleoTUPS Design and Interface**
      Provides an overview of the design and interface of PyleoTUPS.

   .. grid-item-card::
      :img-top: _static/thumbs/01_d_credentials.png
      :link: https://linked.earth/pyleotupsTutorials/d-pangaeacredentialsetup/
      :link-type: url
      :text-align: left

      **PANGAEA Credentials**
      Provides instructions for setting up PANGAEA credentials for use with PyleoTUPS.

Working with PyleoTUPS
"""""""""""""""""""""""

.. grid:: 4
   :gutter: 2
   :margin: 2

   .. grid-item-card::
      :img-top: _static/thumbs/02_a_NOAAObject.png
      :link: https://linked.earth/pyleotupsTutorials/a-noaaobject/
      :link-type: url
      :text-align: left

      **NOAADataset Object**
      Provides an overview of the functionalities associated with the NOAADataset object.

   .. grid-item-card::
      :img-top: _static/thumbs/02_b_PANGAEAObject.png
      :link: https://linked.earth/pyleotupsTutorials/b-pangaeaobject/
      :link-type: url
      :text-align: left

      **PANGAEAObject Object**
      Provides an overview of the functionalities associated with the PANGAEAObject object.

   .. grid-item-card::
      :img-top: _static/thumbs/02_c_NOAAQuery.png
      :link: https://linked.earth/pyleotupsTutorials/c-noaasearch/
      :link-type: url
      :text-align: left

      **NOAA Query**
      Provides examples of how to query the NOAA NCEI Paleoclimate database using PyleoTUPS.

   .. grid-item-card::
      :img-top: _static/thumbs/02_d_PANGAEAQuery.png
      :link: https://linked.earth/pyleotupsTutorials/d-pangaeasearch/
      :link-type: url
      :text-align: left

      **PANGAEA Query**
      Provides examples of how to query the PANGAEA database using PyleoTUPS.

Doing Science with PyleoTUPS
""""""""""""""""""""""""""""

.. grid:: 3
   :gutter: 2
   :margin: 2

   .. grid-item-card::
      :img-top: _static/thumbs/03_a_NOAALiPD.png
      :link: https://linked.earth/pyleotupsTutorials/a-noaa-to-lipd/
      :link-type: url
      :text-align: left

      **Creating LiPD Datasets from NOAA Data**
      Provides an example of how to create a LiPD dataset from NOAA data retrieved using PyleoTUPS.

   .. grid-item-card::
      :img-top: _static/thumbs/03_b_PANGAEALiPD.png
      :link: https://linked.earth/pyleotupsTutorials/b-pangaea-to-lipd/
      :link-type: url
      :text-align: left

      **Creating LiPD Datasets from PANGAEA Data**
      Provides an example of how to create a LiPD dataset from PANGAEA data retrieved using PyleoTUPS.

   .. grid-item-card::
      :img-top: _static/thumbs/03_c_Australia.png
      :link: https://linked.earth/pyleotupsTutorials/c-australianlake/
      :link-type: url
      :text-align: left

      **Obtaining Lake Records from Australia over the Common Era**
      Provides an example of how to obtain lake records from Australia over the Common Era using PyleoTUPS.