FgcmMakeLutTask

FgcmMakeLutTask computes a look-up table tracking atmosphere and instrumental variations for use in the fgcmcal fits. The intention is that this is run once for a given observatory/instrument and should only be updated when instrumental parameters change (e.g., updated filter and ccd throughput curves), or in the extremely rare case if an observatory is relocated to a different elevation or latitude.

This is the first task in a typical fgcmcal processing chain. The second is FgcmBuildStarsTableTask or lsst.fgcmcal.fgcmBuildStars.FgcmBuildStarsTask, the third is FgcmFitCycleTask, and the fourth is FgcmOutputProductsTask.

Processing summary

FgcmMakeLutTask uses an input atmosphere table (preferable) or a list of atmosphere parameters, combined with the instrumental throughput as a function of position, to compute a look-up table used in the fgcmcal fits.

Python API summary

from lsst.fgcmcal.fgcmMakeLut import FgcmMakeLutTask
classFgcmMakeLutTask(initInputs=None, **kwargs)

Make Look-Up Table for FGCM...

attributeconfig

Access configuration fields and retargetable subtasks.

methodrun(**kwargs)

Run task algorithm on in-memory data...

See also

See the FgcmMakeLutTask API reference for complete details.

Retargetable subtasks

No subtasks.

Configuration fields

atmosphereTableName

Default
None
Field type

str Field (optional)

FGCM name or filename of precomputed atmospheres

connections

Data type

lsst.pipe.base.config.FgcmMakeLutConfigConnections

Field type

ConfigField

Configurations describing the connections of the PipelineTask to datatypes

doOpticsTransmission

Default
True
Field type

bool Field

Include optics transmission?

doSensorTransmission

Default
True
Field type

bool Field

Include sensor transmission?

parameters

Data type

lsst.fgcmcal.fgcmMakeLut.FgcmMakeLutParametersConfig

Field type

ConfigField

Atmosphere parameters (required if no atmosphereTableName)

physicalFilters

Default
[]
Field type

str ListField

List of physicalFilter labels to generate look-up table.

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. Deprecated: This field is deprecated and will be removed after v26.

sensorCorrectionTermDict

Default
{}
Field type

ConfigDictField

Key type

str

Value type

lsst.fgcmcal.fgcmMakeLut.SensorCorrectionTerms

Mapping of filter name to sensor correction terms.

stdPhysicalFilterOverrideMap

Default
{}
Field type

DictField

Key type

str

Value type

str

Override mapping from physical filter labels to ‘standard’ physical filter labels. The ‘standard’ physical filter defines the transmission curve that the FGCM standard bandpass will be based on. Any filter not listed here will be mapped to itself (e.g. g->g or HSC-G->HSC-G). Use this override for cross-filter calibration such as HSC-R->HSC-R2 and HSC-I->HSC-I2.

Examples

See the cookbook for worked examples.