lsst.fgcmcal

The lsst.fgcmcal module runs the Forward Global Calibration Method (FGCM) to perform global photometric survey calibration for the Rubin Observatory LSST. Please see Burke, Rykoff, et al. 2018 for the paper describing the method. This lsst.fgcmcal package wraps the third-party package fgcm.

Using lsst.fgcmcal

Please see the cookbook for a runthrough on how to use lsst.fgcmcal.

There are four tasks to be run in a typical global fgcmcal processing chain. They are:

  1. Make a look-up table: FgcmMakeLutTask

  2. Build the star lists: FgcmBuildStarsTableTask (if sourceTable_visit parquet tables are available) or tasks/lsst.fgcmcal.fgcmBuildStars.FgcmBuildStarsTask

  3. Run the fitter: FgcmFitCycleTask

  4. Output the final products: FgcmOutputProductsTask

Alternatively, fgcmcal can be run on a single tract (with multi-band coverage), although the results will not be as robust as a full global calibration. This can be run with FgcmCalibrateTractTableTask or tasks/lsst.fgcmcal.fgcmCalibrateTract.FgcmCalibrateTractTask, which will run all of the tasks above except for the making of the look-up table.

Contributing

lsst.fgcmcal is developed at https://github.com/lsst/fgcmcal. You can find Jira issues for this module under the fgcmcal component.

Command-line tasks

No topics.

Configurations

FgcmCalibrateTractTableConfig

Config for FgcmCalibrateTractTable task

FgcmFitCycleConfig

Config for FgcmFitCycle

FgcmLoadReferenceCatalogConfig

Config for FgcmLoadReferenceCatalogTask

FgcmMakeLutConfig

Config for FgcmMakeLutTask

FgcmOutputProductsConfig

Config for FgcmOutputProductsTask

Sedboundaryterm

SED boundary term for a pair of bands.

SedboundarytermDict

A mapping of Sedboundaryterm name to Sedterm.

Sedterm

SED term for a single band.

SedtermDict

A mapping of bands to Sedterms.

Python API reference

lsst.fgcmcal Package

Classes

FgcmBuildStarsBaseTask([initInputs])

Base task to build stars for FGCM global calibration

FgcmBuildStarsConfigBase(*args, **kw)

Base config for FgcmBuildStars tasks

FgcmBuildStarsTableConfig(*args, **kw)

Config for FgcmBuildStarsTableTask

FgcmBuildStarsTableTask([initInputs])

Build stars for the FGCM global calibration, using sourceTable_visit catalogs.

FgcmCalibrateTractBaseTask([initInputs])

Base class to calibrate a single tract using fgcmcal

FgcmCalibrateTractConfigBase(*args, **kw)

Config for FgcmCalibrateTract

FgcmCalibrateTractTableConfig(*args, **kw)

Config for FgcmCalibrateTractTable task

FgcmCalibrateTractTableTask([initInputs])

Calibrate a single tract using fgcmcal, using sourceTable_visit (parquet) input catalogs.

FgcmFitCycleConfig(*args, **kw)

Config for FgcmFitCycle

FgcmFitCycleTask([initInputs])

Run Single fit cycle for FGCM global calibration

FgcmLoadReferenceCatalogConfig(*args, **kw)

Config for FgcmLoadReferenceCatalogTask

FgcmLoadReferenceCatalogTask([refObjLoader, ...])

Load multi-band reference objects from a reference catalog.

FgcmMakeLutConfig(*args, **kw)

Config for FgcmMakeLutTask

FgcmMakeLutParametersConfig(*args, **kw)

Config for parameters if atmosphereTableName not available

FgcmMakeLutTask([butler, initInputs])

Make Look-Up Table for FGCM.

FgcmOutputProductsConfig(*args, **kw)

Config for FgcmOutputProductsTask

FgcmOutputProductsTask(**kwargs)

Output products from FGCM global calibration.

FocalPlaneProjector(camera, defaultOrientation)

Class to project the focal plane onto the sky.

PhotoCalibConsolidateGen2Gen3Config(*args, **kw)

PhotoCalibConsolidateGen2Gen3Connections(*)

PhotoCalibConsolidateGen2Gen3Task([butler])

Consolidate gen2 photocalibs into gen3 photocalibs.

Sedboundaryterm(*args, **kw)

SED boundary term for a pair of bands.

SedboundarytermDict(*args, **kw)

A mapping of Sedboundaryterm name to Sedterm.

Sedterm(*args, **kw)

SED term for a single band.

SedtermDict(*args, **kw)

A mapping of bands to Sedterms.

SkyWcsConsolidateGen2Gen3Config(*args, **kw)

SkyWcsConsolidateGen2Gen3Connections(*[, config])

SkyWcsConsolidateGen2Gen3Task([butler])

Consolidate gen2 skywcss into gen3 skywcss.