lsst.obs.base
18.1.0-21-gde80ed3+5
|
Public Member Functions | |
def | __init__ |
def | isDatasetTypeSpecial |
def | isDirectorySpecial |
def | iterMappings (self) |
def | makeDataIdExtractor |
def | iterDatasets (self) |
def | prep (self) |
def | insertDimensionData (self) |
def | ingest (self) |
def | getButler |
Public Attributes | |
task | |
root | |
subset | |
An abstract base class for objects that help `ConvertRepoTask` convert datasets from a single Gen2 repository. Parameters ---------- task : `ConvertRepoTask` Task instance that is using this helper object. v Notes ----- `RepoConverter` defines the only public API users of its subclasses should use (`prep`, `insertDimensionRecords`, and `ingest`). These delegate to several abstract methods that subclasses must implement. In some cases, subclasses may reimplement the public methods as well, but are expected to delegate to ``super()`` either at the beginning or end of their own implementation.
Definition at line 224 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.__init__ | ( | self, | |
task | |||
) |
Definition at line 244 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.getButler | ( | self, | |
datasetTypeName | |||
) |
Definition at line 469 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.ingest | ( | self | ) |
Insert converted datasets into the Gen3 repository. Subclasses may override this method, but must delegate to the base class implementation at some point in their own logic. More often, subclasses will specialize the behavior of `ingest` simply by overriding `iterDatasets` and `isDirectorySpecial`, to which the base implementation delegates. This method is guaranteed to be called after both `prep` and `insertDimensionData`.
Definition at line 436 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.insertDimensionData | ( | self | ) |
Insert any dimension records uniquely derived from this repository into the registry. Subclasses may override this method, but may not need to; the default implementation does nothing. SkyMap and SkyPix dimensions should instead be handled by calling `ConvertRepoTask.useSkyMap` or `ConvertRepoTask.useSkyPix`, because these dimensions are in general shared by multiple Gen2 repositories. This method is guaranteed to be called between `prep` and `ingest`.
Definition at line 421 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.isDatasetTypeSpecial | ( | self, | |
datasetTypeName | |||
) |
Definition at line 254 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.isDirectorySpecial | ( | self, | |
subdirectory | |||
) |
Definition at line 272 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.iterDatasets | ( | self, | |
Iterator, | |||
Tuple, | |||
str, | |||
DatasetRef | |||
) |
Iterate over all datasets in the repository that should be ingested into the Gen3 repository. Subclasses may override this method, but must delegate to the base class implementation at some point in their own logic. Yields ------ fileNameInRoot : `str` Name of the file to be ingested, relative to the repository root. ref : `lsst.daf.butler.DatasetRef` Reference for the Gen3 datasets, including a complete `DatasetType` and data ID.
Definition at line 340 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.iterMappings | ( | self, | |
Iterator, | |||
Tuple, | |||
str, | |||
CameraMapperMapping | |||
) |
Iterate over all `CameraMapper` `Mapping` objects that should be considered for conversion by this repository. This this should include any datasets that may appear in the repository, including those that are special (see `isDatasetTypeSpecial`) and those that are being ignored (see `ConvertRepoTask.isDatasetTypeIncluded`); this allows the converter to identify and hence skip these datasets quietly instead of warning about them as unrecognized. Yields ------ datasetTypeName: `str` Name of the dataset type. mapping : `lsst.obs.base.mapping.Mapping` Mapping object used by the Gen2 `CameraMapper` to describe the dataset type.
Definition at line 294 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.makeDataIdExtractor | ( | self, | |
datasetTypeName | |||
) |
Definition at line 316 of file repoConverter.py.
def lsst.obs.base.gen2to3.repoConverter.RepoConverter.prep | ( | self | ) |
Prepare the repository by identifying the dataset types to be converted and building `DataIdExtractor` instance for them. Subclasses may override this method, but must delegate to the base class implementation at some point in their own logic. More often, subclasses will specialize the behavior of `prep` simply by overriding `iterMappings`, `isDatasetTypeSpecial`, and `makeDataIdExtractor`, to which the base implementation delegates. This should not perform any write operations to the Gen3 repository. It is guaranteed to be called before `insertDimensionData` and `ingest`.
Definition at line 381 of file repoConverter.py.
lsst.obs.base.gen2to3.repoConverter.RepoConverter.root |
Definition at line 247 of file repoConverter.py.
lsst.obs.base.gen2to3.repoConverter.RepoConverter.subset |
Definition at line 248 of file repoConverter.py.
lsst.obs.base.gen2to3.repoConverter.RepoConverter.task |
Definition at line 246 of file repoConverter.py.