lsst.faro

The lsst.faro module contains code for computing scientific performance metrics on the outputs of the LSST science pipelines.

Prior to the development of the Gen3 middleware, the Gen2-based lsst.validate.drp package computed scientific performance metrics. lsst.faro is the new Gen3 middleware- and PipelineTask- based package for computing scientific performance metrics. The algorithms implemented in validate_drp were ported as-is to run in lsst.faro. validate_drp is now deprecated; all future development of metrics will be carried out in lsst.faro.

Design and Development

• References and prior art
• Design goals
• Architecture
• Organization of the faro package

Using faro

• Getting started
• Running faro
• Adding a metric to faro

Contributing

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

Python API reference

lsst.faro Package

lsst.faro.base Package

Classes

CatalogMeasurementBaseConfig(*args, **kw)	Configuration for CatalogMeasurementBaseTask.
CatalogMeasurementBaseConnections(*[, config])
CatalogMeasurementBaseTask(config, *args, ...)	Base class for science performance metrics measured from source/object catalogs.
CatalogSummaryBaseConfig(*args, **kw)
CatalogSummaryBaseConnections(*[, config])
CatalogSummaryBaseTask(config, *args, **kwargs)
MatchedBaseConfig(*args, **kw)
MatchedBaseConnections(*[, config])
MatchedBaseTask(config, *args, **kwargs)
MatchedTractBaseTask(config, *args, **kwargs)
NumSourcesMatchedTask([config, name, ...])	Extension of NumSourcesTask to count sources in a matched catalog
NumSourcesMergeTask([config, name, ...])
NumSourcesTask([config, name, parentTask, log])	Simple default task to count the number of sources/objects in catalog.
NumpySummaryConfig(*args, **kw)
NumpySummaryTask([config, name, parentTask, log])

lsst.faro.preparation Package

Classes

PatchMatchedMultiBandPreparationConfig(...)
PatchMatchedMultiBandPreparationConnections(*)
PatchMatchedMultiBandPreparationTask(config, ...)
PatchMatchedPreparationConfig(*args, **kw)
PatchMatchedPreparationConnections(*[, config])
PatchMatchedPreparationTask(config, *args, ...)
TractMatchedPreparationConfig(*args, **kw)
TractMatchedPreparationConnections(*[, config])
TractMatchedPreparationTask(config, *args, ...)

lsst.faro.measurement Package

Classes

AB1Config(*args, **kw)
AB1Task([config, name, parentTask, log])
ADxTask([config, name, parentTask, log])
AFxTask([config, name, parentTask, log])
AMxConfig(*args, **kw)
AMxTask([config, name, parentTask, log])
DetectorMeasurementConfig(*args, **kw)
DetectorMeasurementTask(config, *args, **kwargs)
DetectorTableMeasurementConfig(*args, **kw)	Configuration for DetectorTableMeasurementTask.
DetectorTableMeasurementTask(config, *args, ...)	Base class for science performance metrics measured on single-detector source catalogs.
HistMedianTask([config, name, parentTask, log])
ModelPhotRepTask(config, *args, **kwargs)	A Task that computes a ModelPhotRep photometric repeatability metric
PA1Config(*args, **kw)	Config fields for the PA1 photometric repeatability metric.
PA1Task(config, *args, **kwargs)	A Task that computes the PA1 photometric repeatability metric from an input set of multiple visits of the same field.
PF1Config(*args, **kw)
PF1Task(config, *args, **kwargs)	A Task that computes PF1, the percentage of photometric repeatability measurements that deviate by more than PA2 mmag from the mean.
PatchMatchedMeasurementConfig(*args, **kw)
PatchMatchedMeasurementConnections(*[, config])
PatchMatchedMeasurementTask(config, *args, ...)
PatchMatchedMultiBandMeasurementConfig(...)
PatchMatchedMultiBandMeasurementConnections(*)
PatchMatchedMultiBandMeasurementTask(config, ...)
PatchMeasurementConfig(*args, **kw)
PatchMeasurementConnections(*[, config])
PatchMeasurementTask(config, *args, **kwargs)
StarFracTask([config, name, parentTask, log])
TExConfig(*args, **kw)
TExTask([config, name, parentTask, log])
TractMatchedMeasurementConfig(*args, **kw)
TractMatchedMeasurementConnections(*[, config])
TractMatchedMeasurementTask(config, *args, ...)
TractMeasurementConfig(*args, **kw)
TractMeasurementConnections(*[, config])
TractMeasurementTask(config, *args, **kwargs)
TractMultiBandMeasurementConfig(*args, **kw)
TractMultiBandMeasurementConnections(*[, config])
TractMultiBandMeasurementTask(config, *args, ...)
VisitMeasurementConfig(*args, **kw)
VisitMeasurementTask(config, *args, **kwargs)
VisitTableMeasurementConfig(*args, **kw)	Configuration for VisitTableMeasurementTask.
VisitTableMeasurementTask(config, *args, ...)	Base class for science performance metrics measured on single-visit source catalogs.
WPerpConfig(*args, **kw)
WPerpTask([config, name, parentTask, log])

lsst.faro.summary Package

Classes

PatchMatchedSummaryConfig(*args, **kw)
PatchMatchedSummaryConnections(*[, config])
PatchMatchedSummaryTask(config, *args, **kwargs)
PatchSummaryConfig(*args, **kw)
PatchSummaryConnections(*[, config])
PatchSummaryTask(config, *args, **kwargs)
TractMatchedSummaryConfig(*args, **kw)
TractMatchedSummaryConnections(*[, config])
TractMatchedSummaryTask(config, *args, **kwargs)
VisitSummaryConfig(*args, **kw)
VisitSummaryConnections(*[, config])
VisitSummaryTask(config, *args, **kwargs)

lsst.faro.utils Module