StorageClass

class lsst.daf.butler.StorageClass(name=None, pytype=None, components=None, parameters=None, assembler=None)

Bases: object

Class describing how a label maps to a particular Python type.

Parameters

namestr

Name to use for this class.

pytypetype

Python type (or name of type) to associate with the StorageClass

componentsdict, optional

dict mapping name of a component to another StorageClass.

parametersSequence or Set

Parameters understood by this StorageClass.

assemblerstr, optional

Fully qualified name of class supporting assembly and disassembly of a pytype instance.

Attributes Summary

assemblerClass	Class to use to (dis)assemble an object from components.
components	Component names mapped to associated StorageClass
defaultAssemblerName
parameters	set of names of parameters supported by this StorageClass
pytype	Python type associated with this StorageClass.

Methods Summary

assembler()	Return an instance of an assembler.
filterParameters(parameters[, subset])	Filter out parameters that are not known to this StorageClass
isComposite()	Boolean indicating whether this StorageClass is a composite or not.
knownParameters()	Return set of all parameters known to this StorageClass
validateInstance(instance)	Check that the supplied Python object has the expected Python type
validateParameters([parameters])	Check that the parameters are known to this StorageClass

Attributes Documentation

assemblerClass

Class to use to (dis)assemble an object from components.

components

Component names mapped to associated StorageClass

defaultAssemblerName = 'lsst.daf.butler.core.assembler.CompositeAssembler'

parameters

set of names of parameters supported by this StorageClass

pytype

Python type associated with this StorageClass.

Methods Documentation

assembler()

Return an instance of an assembler.

Returns

assemblerCompositeAssembler

Instance of the assembler associated with this StorageClass. Assembler is constructed with this StorageClass.

Raises

TypeError

This StorageClass has no associated assembler.

filterParameters(parameters, subset=None)

Filter out parameters that are not known to this StorageClass

Parameters

parametersdict, optional

Candidate parameters. Can be None if no parameters have been provided.

subsetCollection, optional

Subset of supported parameters that the caller is interested in using. The subset must be known to the StorageClass if specified.

Returns

filtereddict

Valid parameters. Empty dict if none are suitable.

isComposite()

Boolean indicating whether this StorageClass is a composite or not.

Returns

isCompositebool

True if this StorageClass is a composite, False otherwise.

knownParameters()

Return set of all parameters known to this StorageClass

The set includes parameters understood by components of a composite.

Returns

knownset

All parameter keys of this StorageClass and the component storage classes.

validateInstance(instance)

Check that the supplied Python object has the expected Python type

Parameters

instanceobject

Object to check.

Returns

isOkbool

True if the supplied instance object can be handled by this StorageClass, False otherwise.

validateParameters(parameters=None)

Check that the parameters are known to this StorageClass

Does not check the values.

Parameters

parametersCollection, optional

Collection containing the parameters. Can be dict-like or set-like. The parameter values are not checked. If no parameters are supplied, always returns without error.

Raises

KeyError

Some parameters are not understood by this StorageClass.