Syllabus.md

Stack Club Course Syllabus

Contents:

1. Basics
2. Getting Started
3. Visualization
4. Processing Single Visits
5. Source Detection
6. Image Coaddition
7. Sky background estimation
8. PSF estimation
9. Object deblending
10. Source/Object measurement
11. Astrometric calibration
12. Photometric calibration
13. Difference Image Analysis
14. Data Validation

1. Basics

In this Session we will provide a first glimpse at how to access LSST data on the LSST Science Platform (LSP), introducing the Butler and touring the basic image and catalog data structures.

• Topics:

  • Getting started on the LSP
  • Accessing LSST data with the Butler
  • A Guided tour of a calexp object
  • A Guided tour of an afwtable object
  • The datasets available on the LSP

• Stack Club Resources:

  • GettingStarted.md
  • Calexp_guided_tour.ipynb
  • afw_table_guided_tour.ipynb (Under construction: PR#116)
  • Exploring_A_Data_Repo.ipynb (Under construction: PR#128)
  • DataInventory.ipynb (Under construction: PR#128)

• Other References:

  • DM team: "Getting started with the LSST Science Pipelines"

2. Getting Started

In this Session we will give some introduction to the Stack Club tutorials and GitHub workflow, provide a template for your first tutorial notebook, and show you how to find documentation about the LSST science pipelines.

• Topics:

  • Getting started with the Stack Club
  • Github Basics
  • Creating your First Notebook
  • Finding documentation

• Stack Club Resources:

  • GettingStarted.md
  • HelloWorld.ipynb
  • template_Notebook.ipynb
  • FindingDocs.ipynb

• Other References:

  • DM team: "Getting started with the LSST Science Pipelines"

3. Visualization

We will explore LSST data visualization in a bit more detail. This session will start out from where we left off in the data access tutorials, but will take a deeper dive into some more powerful resources built into the LSST Stack.

• Topics:

  • Image visualization tools: AFW display, Firefly
  • RGB cutouts (Tutorial needed: #129)
  • Image, mask, catalog visualization: Firefly
  • Interactive catalog visualizatio: Bokeh, HoloViews, DataShader
  • Survey visualization (tracts and patches, on the sky)

• Stack Club Resources:

  • AFW_Display_Demo.ipynb
  • bokeh_holoviews_datashader.ipynb (Under construction: PR#103)
  • Exploring_A_Data_Repo.ipynb (Under construction: PR#128)

• Other Resources:

  • SQRE team: Firefly.ipynb
  • DESC: dm_butler_postage_stamps.ipynb

4. Processing Single Visits

• Topics:

  • Detrending, calibration, instrument signature removal
  • lsst_apps package
  • Overscan, flat-fielding, bias
  • ISR (including mask bits)

• Stack Club Resources:

  • Re-RunHSC.ipynb (Under construction: PR#86)
  • PipelineProcessingAPI.ipynb (Under construction: PR#93)
  • BrighterFatterCorrection.ipynb

• Other Resources:

  • DM team: "Getting started tutorial part 2: calibrating single frames with processCcd.py"
  • DM team: "Getting started tutorial part 1: setting up the Butler data repository"
  • DM team: "Using the LSST DM Stack in Python"

5. Source Detection

• Topics:

  • Source detection (visit images, coadd images), Footprints (and Heavy Footprints) (Tutorial needed: #131)
  • Using Stack tools to go beyond the standard pipeline, eg to find low surface brightness galaxies

• Stack Club Resources:

  • afw_table_guided_tour.ipynb (Under construction: PR#116)
  • LowSurfaceBrightness.ipynb

• Other Resources:

  • DM team: "Getting started tutorial part 2: calibrating single frames with processCcd.py"
  • DM team: "Getting started tutorial part 5: measuring sources"
  • Robert Lupton's demos: Greco LSB.ipynb

6. Image Coaddition

• Topics:

  • Remapping
  • PSF homogenization
  • Masking
  • Template generation for DIA

• Stack Club Resources:

  • DIA_How_To_Generate_a_Template_Image.ipynb (in progress)

• Other Resources

  • coaddition.html

7. Sky background estimation

• Topics:

  • The sky background problem
  • How is sky background derived?
  • Validating the sky background

• Stack Club Resources:

  • None

• Other Resources:

  • https://github.com/lsst-dm-tutorial/lsst2017/blob/master/tutorial.ipynb

8. PSF estimation

• Topics:

  • Where does the PSF come from?
  • How is the PSF estimated?
  • Diffraction spikes
  • How do we visualize the psf

• Stack Club Resources:

  • Image_quality_demo.ipynb
  • PSF and shears?

• Other Resources:

  • PSF.ipynb

9. Object deblending

• Topics:

  • Deblending with the SDSS deblender
  • Deblending with Scarlet

• Stack Club Resources:

  • scarlet_tutorial.ipynb
  • lsst_stack_deblender.ipynb

• Other Resources:

  • Robert Lupton's demos: Deblender.ipynb

10. Source/Object measurement

• Topics:

  • Photometry
  • Aperture magnitudes
  • PSF magnitudes
  • Model magnitudes
  • Shapes
  • Light curves

• Stack Club Resources:

  • None

• Other Resources:

  • Source measurement tutorial
  • Kron.ipynb

11. Astrometric calibration

• Topics:

  • Internal astrometry
  • External astrometry

• Stack Club Resources

  • None

• Other Resources:

  • None

12. Photometric calibration

• Topics:

  • Photometric standards
  • Relative photometry
  • Absolute photometry
  • SLR and other validation techniques
  • Galactic Extinction and other bugaboos

• Stack Club Resources

  • None

• Other Resources:

  • Multiband analysis tutorial

13. Difference Image Analysis

• Topics:

  • Template generation (noting any differences from coadd generation)
  • Image differencing
  • DIASource detection
  • DIAObject generation
  • Real/bogus classification
  • Alerts (Tutorial needed: #)
  • Moving objects (Tutorial needed: #)

• Stack Club Resources:

  • DIA Notebooks (to be developed)

• Other Resources

  • Twinkles and DC2 cookbooks?
  • Ask Eric Bellm for leads?

14. Data Validation

• Topics:

  • Available packages: validate_drp, pipeline_analysis
  • Example analysis of various measurements, comparing to external surveys or simulation truth.

• Stack Club Resources:

  • Image_quality_demo.ipynb

• Other Resources:

  • None