ApdbMetricTask

ApdbMetricTask is a base class for generating Measurements from an Alert Production Database. The class handles loading an appropriately configured database, while subclasses are responsible for creating the Measurement using the database API.

Processing summary

ApdbMetricTask runs this sequence of operations:

1. Generate an Apdb object from the config in apdb_config_url.

2. Process the database by passing it to the customizable makeMeasurement method, and return the Measurement.

Python API summary

from lsst.verify.tasks.apdbMetricTask import ApdbMetricTask

classApdbMetricTask(**kwargs)

A base class for tasks that compute metrics from an alert production database...

attributeconfig

Access configuration fields and retargetable subtasks.

methodrun(dbInfo, outputDataId={})

Compute a measurement from a database...

See also

See the ApdbMetricTask API reference for complete details.

Butler datasets

Input datasets

dbInfo

A Butler dataset whose presence guarantees the APDB has been updated. The dataset itself is never used.

Output datasets

measurement

The value of the metric. The dataset type should not be configured directly, but should be set changing the package and metric template variables to the metric’s namespace (package, by convention) and in-package name, respectively. Subclasses that only support one metric should set these variables automatically.

Retargetable subtasks

No subtasks.

Configuration fields

apdb_config_url

Default

None

Field type

str Field

A config file specifying the APDB and its connection parameters, typically written by the apdb-cli command-line utility.

connections

Data type

lsst.pipe.base.config.ApdbMetricConfigConnections

Field type

ConfigField

Configurations describing the connections of the PipelineTask to datatypes

saveLogOutput

Default

True

Field type

bool Field

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