StoredFileInfo

class lsst.daf.butler.StoredFileInfo(formatter: FormatterParameter, path: str, storageClass: StorageClass, component: Optional[str], checksum: Optional[str], file_size: int, dataset_id: DatasetId)

Bases: lsst.daf.butler.StoredDatastoreItemInfo

Datastore-private metadata associated with a Datastore file.

Attributes Summary

checksum Checksum of the serialized dataset.
component Component associated with this file.
dataset_id DatasetId associated with this record.
file_size Size of the serialized dataset in bytes.
formatter Fully-qualified name of Formatter.
path Path to dataset within Datastore.
storageClass StorageClass associated with Dataset.
storageClassFactory

Methods Summary

file_location(factory) Return the location of artifact.
from_record(record, Any]) Create instance from database record.
rebase(ref) Return a copy of the record suitable for a specified reference.
to_record() Convert the supplied ref to a database record.

Attributes Documentation

checksum

Checksum of the serialized dataset.

component

Component associated with this file. Can be None if the file does not refer to a component of a composite.

dataset_id

DatasetId associated with this record.

file_size

Size of the serialized dataset in bytes.

formatter

Fully-qualified name of Formatter. If a Formatter class or instance is given the name will be extracted.

path

Path to dataset within Datastore.

storageClass

StorageClass associated with Dataset.

storageClassFactory = <lsst.daf.butler.core.storageClass.StorageClassFactory object>

Methods Documentation

file_location(factory: lsst.daf.butler.core.location.LocationFactory) → lsst.daf.butler.core.location.Location

Return the location of artifact.

Parameters:
factory : LocationFactory

Factory relevant to the datastore represented by this item.

Returns:
location : Location

The location of the item within this datastore.

classmethod from_record(record: Dict[str, Any]) → lsst.daf.butler.core.storedFileInfo.StoredFileInfo

Create instance from database record.

Parameters:
record : dict

The record associated with this item.

Returns:
info : StoredFileInfo

The newly-constructed item corresponding to the record.

rebase(ref: DatasetRef) → StoredFileInfo

Return a copy of the record suitable for a specified reference.

Parameters:
ref : DatasetRef

DatasetRef which provides component name and dataset ID for the new returned record.

Returns:
record : StoredFileInfo

New record instance.

to_record() → Dict[str, Any]

Convert the supplied ref to a database record.