Metric#

class lsst.verify.Metric(name, description, unit, tags=None, reference_doc=None, reference_url=None, reference_page=None)#

Container for the definition of a metric.

Metrics can either be instantiated programatically, or from a metric YAML file through lsst.verify.MetricSet.

Parameters#

namestr: Name of the metric (e.g., 'PA1').
descriptionstr: Short description about the metric.
unitstr or astropy.units.Unit: Units of the metric. Measurements of this metric must be in an equivalent (that is, convertable) unit. Argument can either be an astropy.unit.Unit instance, or a Unit-compatible string representation. Use an empty string, '', or astropy.units.dimensionless_unscaled for a unitless quantity.
tagslist of str: Tags associated with this metric. Tags are user-submitted string tokens that are used to group metrics.
reference_docstr, optional: The document handle that originally defined the metric (e.g., 'LPM-17').
reference_urlstr, optional: The document’s URL.
reference_pagestr, optional: Page where metric in defined in the reference document.

Attributes Summary

`description`	Short description of the metric (`str`).
`json`	`dict` that can be serialized as semantic JSON, compatible with the SQUASH metric service.
`name`	Metric's name (`Name`).
`reference`	Documentation reference as human-readable text (`str`, read-only).
`reference_doc`	Name of the document that specifies this metric (`str`).
`reference_page`	Page number in the document that specifies this metric (`int`).
`reference_url`	URL of the document that specifies this metric (`str`).
`tags`	Tag labels (`set` of `str`).
`unit`	The metric's unit (`astropy.units.Unit`).
`unit_str`	The string representation of the metric's unit (`Unit`-compatible `str`).

Methods Summary

`check_unit`(quantity)	Check that a `Quantity` has equivalent units to this metric.
`deserialize`([name, description, unit, tags, ...])	Create a Metric instance from a parsed YAML/JSON document.

Attributes Documentation

json#: dict that can be serialized as semantic JSON, compatible with the SQUASH metric service.

reference#

Documentation reference as human-readable text (str, read-only).

reference_doc = None#: Name of the document that specifies this metric (str).

reference_page = None#: Page number in the document that specifies this metric (int).

reference_url = None#: URL of the document that specifies this metric (str).

unit_str#: The string representation of the metric’s unit (Unit-compatible str).

Methods Documentation

check_unit(quantity)#

Check that a Quantity has equivalent units to this metric.

is_equivalentbool: True if the units are equivalent, meaning that the quantity can be presented in the units of this metric. False if not.

classmethod deserialize(name=None, description=None, unit=None, tags=None, reference=None)#

Create a Metric instance from a parsed YAML/JSON document.

kwargsdict: Keyword arguments that match fields from the Metric.json serialization.