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.

For instructions on reproducing figures from DESI Collaboration papers:

• DR1 paper figure reproduction repository
• EDR paper figure reproduction repository

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

Y1 Cosmological Analysis

For those interested in Y1 cosmological analysis with DESI data, the following resources provide in-depth guidance:

Note: These tutorials must be run at NERSC using the cosmodesi environment:

source /global/common/software/desi/users/adematti/cosmodesi_environment.sh main  # source the environment
${COSMODESIMODULES}/install_jupyter_kernel.sh main  # this to be done once

1. BAO Analysis This notebook provides a comprehensive introduction to the Baryon Acoustic Oscillation (BAO) analysis. Covers theoretical background, large-scale structure reconstruction, and constraints on cosmological models.

2. Full Shape Analysis This resource covers Full Shape analysis for cosmological constraints. Explains power spectrum measurements, full-shape likelihood, and bias parameters fitting.

These resources are ideal for beginners and experienced researchers alike, providing both theoretical context and practical tools for cosmology research.