Skip to content

Tutorials

DESI provides a number of Jupyter notebook tutorials available at github.com/desihub/tutorials. They provide an informative introduction to key concepts for anyone interested in exploring DESI data.

Getting Started

Note: For detailed instructions on setting up your environment to run these tutorials, see these instructions, which covers both local machine setup and NERSC-based options.

These tutorials can be run either at NERSC or on your local machine by downloading a subset of DESI data.

The 01_getting_started folder within the tutorial repository contains the following Data Release 1 (DR1) tutorials:

  1. 01_QuickStart - A rapid overview of DESI Data Release 1 without requiring DESI-specific code. This tutorial provides basic information to start working with DESI data immediately.

  2. 02_CoreConcepts - An introduction to core concepts for working with DESI data. Covers surveys, programs, tiles, hardware components, and best practices.

  3. 03_DataOrganization - A comprehensive guide to DESI’s data file structure and organization. Explores directory structures, redshift catalogs, and spectra organization by tile and healpix.

  4. 04_RedshiftCatalogs - A detailed exploration of DESI redshift catalogs and how to use them. Covers selection techniques, quality cuts, and target classifications.

  5. 05_Spectra - An in-depth tutorial on working with DESI spectroscopic data. Covers data formats, manipulation techniques, and optimization methods.

  6. 06_PublicDatabaseAccess - A practical guide to accessing DESI data through public databases. Demonstrates querying DESI catalogs and retrieving full-depth spectra using Astro Data Lab and SPARCL tools.

For instructions on reproducing figures from DESI Collaboration papers:

Tutorials for the Early Data Release (EDR) can be found here.