Constraints

class lsst.daf.butler.Constraints(config: Optional[Union[ConstraintsConfig, str]], *, universe: DimensionUniverse)

Bases: object

Determine whether a DatasetRef, DatasetType, or StorageClass is allowed to be handled.

Parameters:
config : ConstraintsConfig or str

Load configuration. If None then this is equivalent to having no restrictions.

universe : DimensionUniverse

The set of all known dimensions, used to normalize any lookup keys involving dimensions.

Attributes Summary

matchAllKey Configuration key associated with matching everything.

Methods Summary

getLookupKeys() Retrieve the look up keys for all the constraints entries.
isAcceptable(entity, DatasetType, StorageClass]) Check whether the supplied entity will be acceptable to whatever this Constraints class is associated with.

Attributes Documentation

matchAllKey = LookupKey(name='all',)

Configuration key associated with matching everything.

Methods Documentation

getLookupKeys() → Set[lsst.daf.butler.core.configSupport.LookupKey]

Retrieve the look up keys for all the constraints entries.

Returns:
keys : set of LookupKey

The keys available for determining constraints. Does not include the special “all” lookup key.

isAcceptable(entity: Union[DatasetRef, DatasetType, StorageClass]) → bool

Check whether the supplied entity will be acceptable to whatever this Constraints class is associated with.

Parameters:
entity : DatasetType, DatasetRef, or StorageClass

Instance to use to look in constraints table. The entity itself reports the LookupKey that is relevant.

Returns:
allowed : bool

True if the entity is allowed.