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.

ApdbMetricTask is currently a subclass of lsst.verify.tasks.MetricTask. It is expected that ApdbMetricTask can be migrated to the Gen 3 framework without affecting its subclasses.

Processing summary

ApdbMetricTask runs this sequence of operations:

1. Load the dataset indicated by dbInfo (default: one or more apdb_marker datasets).

2. Generate an Apdb object by calling the dbLoader subtask (default: DirectApdbLoader).

3. 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

The Butler dataset from which the database connection can be initialized. The type must match the input required by the dbLoader subtask (default: apdb_marker). If the input is a task config, its name must be explicitly configured when running ApdbMetricTask or a MetricsControllerTask that contains it.

Retargetable subtasks

dbLoader

Default

lsst.verify.tasks.apdbMetricTask.DirectApdbLoader

Field type

ConfigurableField

Task for loading a database from dbInfo. Its run method must take one object of the dataset type indicated by dbInfo and return a Struct with an ‘apdb’ member.

Configuration fields

connections

Data type

lsst.pipe.base.config.Connections

Field type

ConfigField

Configurations describing the connections of the PipelineTask to datatypes