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 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 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

FgcmBuildStarsConfig
Config for FgcmBuildStarsTask
FgcmCalibrateTractConfig
Config for FgcmCalibrateTract 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([butler, initInputs]) Base task to build stars for FGCM global calibration
FgcmBuildStarsConfig Config for FgcmBuildStarsTask
FgcmBuildStarsConfigBase Base config for FgcmBuildStars tasks
FgcmBuildStarsRunner(TaskClass, parsedCmd[, …]) Subclass of TaskRunner for FgcmBuildStars tasks
FgcmBuildStarsTableConfig Config for FgcmBuildStarsTableTask
FgcmBuildStarsTableTask([butler, initInputs]) Build stars for the FGCM global calibration, using sourceTable_visit catalogs.
FgcmBuildStarsTask([butler, initInputs]) Build stars for the FGCM global calibration, using src catalogs.
FgcmCalibrateTractBaseTask([butler]) Base class to calibrate a single tract using fgcmcal
FgcmCalibrateTractConfig Config for FgcmCalibrateTract task
FgcmCalibrateTractConfigBase Config for FgcmCalibrateTract
FgcmCalibrateTractRunner(TaskClass, parsedCmd) Subclass of TaskRunner for FgcmCalibrateTractTask
FgcmCalibrateTractTableConfig Config for FgcmCalibrateTractTable task
FgcmCalibrateTractTableTask([butler]) Calibrate a single tract using fgcmcal, using sourceTable_visit (parquet) input catalogs.
FgcmCalibrateTractTask([butler]) Calibrate a single tract using fgcmcal
FgcmFitCycleConfig Config for FgcmFitCycle
FgcmFitCycleRunner(TaskClass, parsedCmd[, …]) Subclass of TaskRunner for fgcmFitCycleTask
FgcmFitCycleTask([butler, initInputs]) Run Single fit cycle for FGCM global calibration
FgcmLoadReferenceCatalogConfig Config for FgcmLoadReferenceCatalogTask
FgcmLoadReferenceCatalogTask([butler, …]) Load multi-band reference objects from a reference catalog.
FgcmMakeLutConfig Config for FgcmMakeLutTask
FgcmMakeLutParametersConfig Config for parameters if atmosphereTableName not available
FgcmMakeLutRunner(TaskClass, parsedCmd[, …]) Subclass of TaskRunner for fgcmMakeLutTask
FgcmMakeLutTask([butler, initInputs]) Make Look-Up Table for FGCM.
FgcmOutputProductsConfig Config for FgcmOutputProductsTask
FgcmOutputProductsRunner(TaskClass, parsedCmd) Subclass of TaskRunner for fgcmOutputProductsTask
FgcmOutputProductsTask([butler]) Output products from FGCM global calibration.
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.