.. _tutorials-python:

The ``dataregistry`` package
============================

The tutorials for the ``dataregistry`` package come in the form of Jupyter
Notebooks (hosted in the ``docs/source/tutorial_notebooks`` directory in the
repository).

These tutorial notebooks can be run interactively at NERSC (see :ref:`here
<interactive-notebooks>` for more info), or serve as standalone reference
material by `viewing the notebooks on GitHub
<https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/>`__. 

1) Getting started with the data registry
-----------------------------------------

**Getting started: Part 1 - Registering datasets**: `Link to notebook <https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/getting_started_1_register.ipynb>`__

**Getting started: Part 2 - Simple queries**: `Link to notebook <https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/getting_started_2_query.ipynb>`__

2) Advanced tutorials
---------------------

**A deeper dive into datasets**: `Link to notebook <https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/datasets_deeper_look.ipynb>`__

**Pipeline datasets**: `Link to notebook <https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/pipelines.ipynb>`__

**The production schema**: `Link to notebook <https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/production_schema.ipynb>`__

**Using GCRCatalogs with dataregistry**:  `Link to notebook <https://github.com/LSSTDESC/dataregistry/blob/main/docs/source/tutorial_notebooks/query_gcr_datasets.ipynb>`__