DatabaseTopologicalFamily¶
- class lsst.daf.butler.DatabaseTopologicalFamily(name: str, space: TopologicalSpace, *, members: NamedValueAbstractSet[DimensionElement])¶
Bases:
TopologicalFamily
Database topological family implementation.
A
TopologicalFamily
implementation for theDatabaseDimension
andDatabaseDimensionCombination
objects that have direct database representations.- Parameters:
- name
str
Name of the family.
- space
TopologicalSpace
Space in which this family’s regions live.
- members
NamedValueAbstractSet
[DimensionElement
] The members of this family, ordered according to the priority used in
choose
(first-choice member first).
- name
Attributes Summary
Return
GovernorDimension
common to all members of this family.Methods Summary
choose
(endpoints, universe)Select the best member of this family to use.
Attributes Documentation
- governor¶
Return
GovernorDimension
common to all members of this family.
Methods Documentation
- choose(endpoints: Set[str], universe: DimensionUniverse) DimensionElement ¶
Select the best member of this family to use.
These are to be used in a query join or data ID when more than one is present.
Usually this should correspond to the most fine-grained region.
- Parameters:
- endpoints
Set
[str
] Endpoints to choose from. May include endpoints that are not members of this family (which should be ignored).
- universe
DimensionUniverse
Object that manages all known dimensions.
- endpoints
- Returns:
- best
TopologicalRelationshipEndpoint
The best endpoint that is both a member of
self
and inendpoints
.
- best