Tutorials

These tutorials are runnable Jupyter notebooks from the notebooks/ directory of the repository, rendered here with their saved outputs. Each one is self-contained — download it and run it interactively to experiment. The Gaia queries they perform are cached in notebooks/gaia_cache/, so they run offline.

Notebook	What it covers
wcc-sim: example usage and verification	The full end-to-end example with verification: simulate a field, overlay the Gaia catalog, compare the three PSF modes, and check astrometry, photometric closure, noise statistics, and saturation.
PSF focus modes: Airy vs defocus	The three PSF modes (in-focus Airy, +1/+2-wave defocus), stamp sizes, oversampling, and the effect of jitter.
Detectors, filters, and count rates	The two detectors (IMX455 vs qCMOS), sensorfilter keys, and how Gaia photometry maps to spectral types and count rates.
Noise and saturation	The ETC noise model step by step, n_reads semantics, per-pixel saturation masks, and the windowed per-star saturated flag.
Astrometry, WCS, and custom catalogs	The TAN WCS, position angles, injecting your own catalog, and astrometric round-trip checks.
The command line and the FITS output	The wcc-sim command line and the multi-extension FITS output, read back with astropy.
PSF wings: no more postage stamps	The analytic PSF wing extension: before/after images at hard stretch, the fitted power-law wing models, seam smoothness at the old stamp edge, and how the wings change the encircled energy.
wcc-phot: differential photometry of a WCC image series	The wcc_phot differential photometry pipeline: target + reference selection, per-frame centroiding, aperture vs PSF fluxes, the relative light curve, and the live viewer hook.