DP0.2 Tutorials

These tutorials are for DP0 delegates using the Rubin Science Platform (RSP) deployed at the Interim Data Facility (IDF; the Google Cloud).

Before following these tutorials, delegates should:

1. have gotten their Delegate-Homepage-RSP-Accounts and be able to log in at data.lsst.cloud,
2. be familiar with this list of RSP Risks and Caveats,
3. have reviewed the basic introductions to the RSP’s Portal Aspect or Notebook Aspect, and
4. know their options for Delegate-Homepage-Getting-Support.

All RSP tutorials are created by Rubin staff and adhere to the set of guidelines and best practices described in RTN-045, unless otherwise noted (e.g., the Contributed tutorials).

Suggest a new tutorial topic.

Major Changes Log

Portal tutorials

A beginner-level overview for the Portal Aspect is provided in this Introduction to the RSP Portal Aspect. More information can also be found in the about firefly page on the Rubin Science Platform Documentation page.

The tutorials below are step-by-step demonstrations of how to use the Portal Aspect for science investigations with the DP0 data set.

Notebook tutorials

A beginner-level overview for the Notebook Aspect is provided in this Introduction to the RSP Notebook Aspect, along with Jupyter notebook frequently asked questions and Troubleshooting tips. More information can also be found in the Notebook Aspect documentation.

All Jupyter Notebook tutorials are kept in the tutorial-notebooks repository of the rubin-dp0 GitHub Organization. The contents of the prod branch of that repository are made available (and automatically updated) in the folder notebooks/tutorial-notebooks which appears in all users’ home directories.

List of Notebook tutorials: See the repository’s README file for the most up-to-date list of available tutorials with descriptions. Spanish-language Jupyter Notebook tutorials have filenames ending in “ES.ipynb”.

Command line tutorials

Much of the contents of the tutorial notebooks (above) can also be executed via the terminal in the Notebook Aspect of the RSP.

API tutorials

The API tutorials will be coming in many flavors, including tutorials using TAP, ObsTAP, SODA (image cutouts and mosaics), and HiPS, and, eventually, SCS for simple catalog searches, SIAv2 for image searches, and VOSpace (in addition to WebDAV) for access to user files.

As a first step, tutorials using the TAP service are provided.

A beginner-level overview for the API Aspect is provided in this Introduction to the RSP API Aspect.

The tutorials below are step-by-step demonstrations of how to use the API Aspect for science investigations with the DP0 data set.

Spanish-language tutorials

Credit: The Argentinian International In-Kind Program team, in particular Dante Paz, Carolina Villalón, and Marco Augusto Rocchietti, have translated several DP0.2 tutorials into Spanish.

Portal tutorials

Notebook tutorials

The introductory DP0.2 Notebook tutorial (DP02_01_Introduccion_a_DP02_ES.ipynb) is available in the tutorial-notebooks repository repository.

Introduccion a DP0.2

Command-line tutorials

Contributed tutorials

Where do contributed tutorials go? In the shared GitHub repository delegate-contributions-dp02. Contributions are stored in sub-directories by topic, such as “extendedness” or “variable stars”. View the readme files in each sub-directory for more information about the contents and who contributed them.

Who can contribute a tutorial? Everyone is welcome to contribute tutorials or science demonstrations to this repo. All are welcome to drop in to a DP0-Delegate-Programming-StackClub session to workshop a tutorial topic or get assistance.

How are contributions made? The README file for this repo contains instructions and best practices for contributions. Rubin staff do not apply any quality control reviews to the contributed content in this repo.

What topics can be contributed? Any and all topics are welcome, so long as they can be covered by the DP0.2 data set. Here is a short list of potential science topics that DP0.2 could be useful for.

  • TAP catalog queries that access external catalogs

  • galaxy shape parameter analysis (weak lensing?)

  • options for Milky Way dust corrections

  • supernova host galaxy association

  • supernova lightcurve fits (cosmology)

  • photometric redshifts

  • galaxy cluster detection and analysis

  • large scale structure (cosmology)

  • variable star lightcurves analysis

  • astrometry-based analyses

Portal usability test answer keys

Answer keys for Portal usability tests can also be used as step-by-step tutorials.