.. _tutorials:

Tutorials
#########

PySTAC Introduction
-------------------

- :tutorial:`GitHub version <pystac-introduction.ipynb>`
- :ref:`Docs version </tutorials/pystac-introduction.ipynb>`

This tutorial gives an introduction to PySTAC concepts through code examples.

How to read data from STAC
--------------------------

- :tutorial:`GitHub version <how-to-read-data-from-stac.ipynb>`
- :ref:`Docs version </tutorials/how-to-read-data-from-stac.ipynb>`

This tutorial shows how to read data from PySTAC into xarray.

PySTAC SpaceNet tutorial
------------------------

- :tutorial:`GitHub version <pystac-spacenet-tutorial.ipynb>`
- :ref:`Docs version </tutorials/pystac-spacenet-tutorial.ipynb>`

This tutorial shows how to create and manipulate a STAC of `SpaceNet <https://spacenetchallenge.github.io/>`_ data.

How to create STAC Catalogs with PySTAC
---------------------------------------

- :tutorial:`GitHub version <how-to-create-stac-catalogs.ipynb>`
- :ref:`Docs version </tutorials/how-to-create-stac-catalogs.ipynb>`

This was a tutorial that was part of a 30 minute presentation at the `community STAC
sprint
<https://github.com/radiantearth/community-sprints/tree/master/11052019-arlignton-va>`_
in Arlington, VA in November 2019. It runs through creating a STAC of images
from the `SpaceNet 5 <https://www.topcoder.com/challenges/30099956>`_ dataset.

Creating a Landsat 8 STAC
-------------------------

- :tutorial:`GitHub version <creating-a-landsat-stac.ipynb>`
- :ref:`Docs version </tutorials/creating-a-landsat-stac.ipynb>`

This tutorial was presented at [Cloud Native Geospatial Outreach
Day](https://sites.google.com/radiant.earth/cng-agenda/) on September 8th, 2020. It
shows how to create a STAC collection from a subset of Landsat 8 scenes over a location.

Adding New and Custom Extensions
--------------------------------

- :tutorial:`GitHub version <adding-new-and-custom-extensions.ipynb>`
- :ref:`Docs version </tutorials/adding-new-and-custom-extensions.ipynb>`

This tutorial goes over how to contribute new extensions to PySTAC as well as how to
implement your own custom extensions.

.. toctree::
    :hidden:
    :maxdepth: 2
    :glob:

    tutorials/pystac-introduction.ipynb
    tutorials/how-to-read-data-from-stac.ipynb
    tutorials/pystac-spacenet-tutorial.ipynb
    tutorials/how-to-create-stac-catalogs.ipynb
    tutorials/creating-a-landsat-stac.ipynb
    tutorials/adding-new-and-custom-extensions.ipynb
