FgcmCalibrateTractTableTask

FgcmCalibrateTractTableTask will run the full fgcmcal processing cycle on a single tract with multi-band coverage. Note that the results will not be as robust as a full global calibration because of the limited ability to track instrumental changes from observations in a single tract. Running FgcmCalibrateTractTableTask requires a look-up table generated by FgcmMakeLutTask.

FgcmCalibrateTractTableTask uses FgcmBuildStarsTableTask to extract stars from sourceTable_visit parquet tables.

Processing summary

FgcmCalibrateTractTableTask runs the full fgcmcal processing, from building star lists to fitting to the output of final products. Specifically, it will:

1. Build the star lists: FgcmBuildStarsTableTask

2. Run the fitter until convergence: FgcmFitCycleTask

3. Output the final data products: FgcmOutputProductsTask

Python API summary

from lsst.fgcmcal.fgcmCalibrateTractTable import FgcmCalibrateTractTableTask

classFgcmCalibrateTractTableTask(initInputs=None, **kwargs)

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

attributeconfig

Access configuration fields and retargetable subtasks.

methodrun(handleDict, tract, buildStarsRefObjLoader=None, returnCatalogs=True)

Run the calibrations for a single tract with fgcm...

See also

See the FgcmCalibrateTractTableTask API reference for complete details.

Retargetable subtasks

fgcmBuildStars

Default

lsst.fgcmcal.fgcmBuildStarsTable.FgcmBuildStarsTableTask

Field type

ConfigurableField

Task to load and match stars for fgcm

fgcmOutputProducts

Default

lsst.fgcmcal.fgcmOutputProducts.FgcmOutputProductsTask

Field type

ConfigurableField

Task to output fgcm products

Configuration fields

connections

Data type

lsst.pipe.base.config.Connections

Field type

ConfigField

Configurations describing the connections of the PipelineTask to datatypes

convergenceTolerance

Default

0.005

Field type

float Field

Tolerance on repeatability convergence (per band)

doDebuggingPlots

Default

False

Field type

bool Field

Make plots for debugging purposes?

fgcmFitCycle

Data type

lsst.fgcmcal.fgcmFitCycle.FgcmFitCycleConfig

Field type

ConfigField

Config to run a single fgcm fit cycle

maxFitCycles

Default

5

Field type

int Field

Maximum number of fit cycles

saveLogOutput

Default

True

Field type

bool Field

Flag to enable/disable saving of log output for a task, enabled by default.

saveMetadata

Default

True

Field type

bool Field

Flag to enable/disable metadata saving for a task, enabled by default.