Specification¶

class lsst.verify.Specification(name, **kwargs)¶

Bases: JsonSerializationMixin

Specification base class.

Specification classes must implement:

type
_serialize_type
check

Subclasses should also call Specification.__init__ to initialize the specifications name attribute (a Name instance).

Attributes Summary

`json`	`dict` that can be serialized as semantic JSON, compatible with the SQUASH metric service.
`metric_name`	Name of the metric this specification corresponds to (`lsst.verify.Name`).
`name`	Specification name (`lsst.verify.Name`).
`tags`	Tag labels (`set` of `str`).
`type`	Specification type (`str`).

Methods Summary

`check`(measurement)	Check if a measurement passes this specification.
`jsonify_dict`(d)	Recursively build JSON-renderable objects on all values in a dict.
`query_metadata`(metadata[, arg_driven])	Query a Job's metadata to determine if this specification applies.
`write_json`(filepath)	Write JSON to a file.

Attributes Documentation

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

metric_name¶: Name of the metric this specification corresponds to (lsst.verify.Name).

name¶: Specification name (lsst.verify.Name).

tags¶: Tag labels (set of str).

type¶: Specification type (str).

Methods Documentation

abstract check(measurement)¶

Check if a measurement passes this specification.

Parameters:

measurementastropy.units.Quantity: The measurement value. The measurement Quantity must have units compatible with the specification.

Returns:

passedbool: True if the measurement meets the specification, False otherwise.

static jsonify_dict(d)¶

Recursively build JSON-renderable objects on all values in a dict.

Parameters:

ddict: Dictionary to convert into a JSON-serializable object. Values are recursively JSON-ified.

Returns:

json_dictdict: Dictionary that can be serialized to JSON.

Examples

Subclasses can use this method to prepare output in their json-method implementation. For example:

def json(self):
    return JsonSerializationMixin.jsonify_dict({
        'value': self.value,
    })

query_metadata(metadata, arg_driven=False)¶

Query a Job’s metadata to determine if this specification applies.

Parameters:

metadatalsst.verify.Metadata or dict-type

Metadata mapping. Typically this is the lsst.verify.Job.meta attribute.

arg_drivenbool, optional

If False (default), metadata matches the MetadataQuery if metadata has all the terms defined in MetadataQuery, and those terms match. If metadata has more terms than MetadataQuery, it can still match. This behavior is appropriate for finding if a specification applies to a Job given metadata.

If True, the orientation of the matching is reversed. Now metadata matches the MetadataQuery if MetadataQuery has all the terms defined in metadata and those terms match. If MetadataQuery has more terms than metadata, it can still match. This behavior is appropriate for discovering specifications.

Returns:

matchedbool: True if this specification matches, False otherwise.

Navigation

Specification¶