LookupKey¶
- class lsst.daf.butler.LookupKey(name: str | None = None, dimensions: Iterable[str | Dimension] | None = None, dataId: Dict[str, Any] | None = None, *, universe: DimensionUniverse | None = None)¶
Bases:
objectRepresentation of key that can be used to lookup information.
Look up is based on dataset type name, storage class name, dimensions.
- Parameters:
- name
str, optional Primary index string for lookup. If this string looks like it represents dimensions (via
dim1+dim2+dim3syntax) the name is converted to aDimensionGraphand stored indimensionsproperty.- dimensions
DimensionGraph, optional Dimensions that are relevant for lookup. Should not be specified if
nameis also specified.- dataId
dict, optional Keys and values from a dataId that should control lookups.
- universe
DimensionUniverse, optional Set of all known dimensions, used to expand and validate
nameordimensions. Required if the key represents dimensions and a fullDimensionGraphis not provided.
- name
Attributes Summary
Return dict of keys/values that are important for dataId lookup.
Dimensions associated with lookup (
DimensionGraph).Primary name string to use as lookup (
str).Methods Summary
clone([name, dimensions, dataId])Clone the object, overriding some options.
Attributes Documentation
- dimensions¶
Dimensions associated with lookup (
DimensionGraph).
Methods Documentation
- clone(name: str | None = None, dimensions: DimensionGraph | None = None, dataId: Dict[str, Any] | None = None) LookupKey¶
Clone the object, overriding some options.
Used to create a new instance of the object whilst updating some of it.
- Parameters:
- name
str, optional Primary index string for lookup. Will override
dimensionsifdimensionsare set.- dimensions
DimensionGraph, optional Dimensions that are relevant for lookup. Will override
nameifnameis already set.- dataId
dict, optional Keys and values from a dataId that should control lookups.
- name
- Returns:
- clone
LookupKey Copy with updates.
- clone