DatasetQueryResults

class lsst.daf.butler.registry.queries.DatasetQueryResults(*args, **kwds)

Bases: Iterable[lsst.daf.butler.DatasetRef]

An interface for objects that represent the results of queries for datasets.

Methods Summary

byParentDatasetType()	Group results by parent dataset type.
expanded()	Return a DatasetQueryResults for which DataCoordinate.hasResults returns True for all data IDs in returned DatasetRef objects.
materialize()	Insert this query’s results into a temporary table.

Methods Documentation

abstract byParentDatasetType() → Iterator[lsst.daf.butler.registry.queries.ParentDatasetQueryResults]

Group results by parent dataset type.

Returns

iterIterator [ ParentDatasetQueryResults ]

An iterator over DatasetQueryResults instances that are each responsible for a single parent dataset type (either just that dataset type, one or more of its component dataset types, or both).

abstract expanded() → lsst.daf.butler.registry.queries.DatasetQueryResults

Return a DatasetQueryResults for which DataCoordinate.hasResults returns True for all data IDs in returned DatasetRef objects.

Returns

expandedDatasetQueryResults

Either a new DatasetQueryResults instance or self, if it is already expanded.

Notes

As with DataCoordinateQueryResults.expanded, it may be more efficient to call materialize before expanding data IDs for very large result sets.

abstract materialize() → AbstractContextManager[lsst.daf.butler.registry.queries.DatasetQueryResults]

Insert this query’s results into a temporary table.

Returns

contexttyping.ContextManager [ DatasetQueryResults ]

A context manager that ensures the temporary table is created and populated in __enter__ (returning a results object backed by that table), and dropped in __exit__. If self is already materialized, the context manager may do nothing (reflecting the fact that an outer context manager should already take care of everything else).