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:
- Make a look-up table: FgcmMakeLutTask
- Build the star lists: FgcmBuildStarsTableTask (if
sourceTable_visitparquet tables are available) or FgcmBuildStarsTask - Run the fitter: FgcmFitCycleTask
- 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([initInputs, butler]) |
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([initInputs]) |
Build stars for the FGCM global calibration, using sourceTable_visit catalogs. |
FgcmBuildStarsTask([initInputs, butler]) |
Build stars for the FGCM global calibration, using src catalogs. |
FgcmCalibrateTractBaseTask([initInputs, 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([initInputs]) |
Calibrate a single tract using fgcmcal, using sourceTable_visit (parquet) input catalogs. |
FgcmCalibrateTractTask([initInputs, 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. |