CollectionQuery¶
- class lsst.daf.butler.registry.wildcards.CollectionQuery(search: CollectionSearch | ellipsis = Ellipsis, patterns: Tuple[Pattern, ...] = ())¶
Bases:
object
An unordered query for collections and dataset type restrictions.
The
fromExpression
method should almost always be used to construct instances, as the regular constructor performs no checking of inputs (and that can lead to confusing error messages downstream).- Parameters:
- search
CollectionSearch
or An object representing an ordered search for explicitly-named collections (to be interpreted here as unordered), or the special value
indicating all collections.
must be accompanied by
patterns=None
.- patterns
tuple
ofre.Pattern
Regular expression patterns to match against collection names.
- universe
DimensionUniverse
Object managing all dimensions.
- search
Notes
A
CollectionQuery
is used to find all matching datasets in any number of collections, or to find collections themselves.CollectionQuery
is expected to be rarely used outside ofRegistry
(which uses it to back several of its “query” methods that take general expressions for collections), but it may occassionally be useful outsideRegistry
as a way to preprocess expressions that contain single-pass iterators into a form that can be used to call thoseRegistry
methods multiple times.Methods Summary
Iterate over collection names that were specified explicitly.
fromExpression
(expression)Process a general expression to construct a
CollectionQuery
instance.iter
(manager, *[, collectionTypes, ...])Iterate over collection records that match this instance and the given criteria, in an arbitrary order.
Methods Documentation
- classmethod fromExpression(expression: Any) CollectionQuery ¶
Process a general expression to construct a
CollectionQuery
instance.- Parameters:
- expression
- May be:
a
str
collection name;an
re.Pattern
instance to match (withre.Pattern.fullmatch
) against collection names;any iterable containing any of the above;
a
CollectionSearch
instance;another
CollectionQuery
instance (passed through unchanged).
Duplicate collection names will be removed (preserving the first appearance of each collection name).
- Returns:
- collections
CollectionQuery
A
CollectionQuery
instance.
- collections
- iter(manager: CollectionManager, *, collectionTypes: AbstractSet[CollectionType] = frozenset({CollectionType.RUN, CollectionType.TAGGED, CollectionType.CHAINED, CollectionType.CALIBRATION}), flattenChains: bool = True, includeChains: bool | None = None) Iterator[CollectionRecord] ¶
Iterate over collection records that match this instance and the given criteria, in an arbitrary order.
This method is primarily intended for internal use by
Registry
; other callers should generally preferRegistry.queryDatasets
or otherRegistry
query methods.- Parameters:
- manager
CollectionManager
Object responsible for managing the collection tables in a
Registry
.- collectionTypes
AbstractSet
[CollectionType
], optional If provided, only yield collections of these types.
- flattenChains
bool
, optional If
True
(default) recursively yield the child collections ofCHAINED
collections.- includeChains
bool
, optional If
False
, return records forCHAINED
collections themselves. The default is the opposite offlattenChains
: either return records for CHAINED collections or their children, but not both.
- manager
- Yields:
- record
CollectionRecord
Matching collection records.
- record