SingleTypeDatasetQueryResults¶

final class lsst.daf.butler.SingleTypeDatasetQueryResults(driver: QueryDriver, tree: QueryTree, spec: DatasetRefResultSpec)¶

Bases: DatasetQueryResults, QueryResultsBase

A query for DatasetRef results with a single dataset type.

Parameters:

driverQueryDriver: Implementation object that knows how to actually execute queries.
treeQueryTree: Description of the query as a tree of joins and column expressions. The instance returned directly by the Butler._query entry point should be constructed via make_unit_query_tree.
specDatasetRefResultSpec: Specification of the query result rows, including output columns, ordering, and slicing.

Notes

This class should never be constructed directly by users; use Query.datasets instead.

Attributes Summary

`data_ids`
`dataset_type`
`has_dimension_records`	Whether all data IDs in this iterable contain dimension records.

Methods Summary

`by_dataset_type`()	Group results by dataset type.
`count`(*[, exact, discard])	Count the number of rows this query would return.
`with_dimension_records`()	Return a results object for which `has_dimension_records` is `True`.

Attributes Documentation

Methods Documentation

Group results by dataset type.

Returns:

iterIterator [ SingleTypeDatasetQueryResults ]: An iterator over DatasetQueryResults instances that are each responsible for a single dataset type.

count(*, exact: bool = True, discard: bool = False) → int¶

Count the number of rows this query would return.

Parameters:

exactbool, optional: If True, run the full query and perform post-query filtering if needed to account for that filtering in the count. If False, the result may be an upper bound.
discardbool, optional: If True, compute the exact count even if it would require running the full query and then throwing away the result rows after counting them. If False, this is an error, as the user would usually be better off executing the query first to fetch its rows into a new query (or passing exact=False). Ignored if exact=False.

Returns:

countint: The number of rows the query would return, or an upper bound if exact=False.

with_dimension_records() → SingleTypeDatasetQueryResults¶: Return a results object for which has_dimension_records is True.