21 from __future__
import annotations
23 __all__ = [
"RootRepoConverter"]
28 from typing
import TYPE_CHECKING, Iterator, Optional, Tuple, List
30 from lsst.skymap
import BaseSkyMap
31 from lsst.daf.butler
import DatasetType, DatasetRef, FileDataset
32 from .standardRepoConverter
import StandardRepoConverter
34 SKYMAP_DATASET_TYPES = {
35 coaddName: f
"{coaddName}Coadd_skyMap" for coaddName
in (
"deep",
"goodSeeing",
"dcr")
39 from lsst.daf.butler
import SkyPixDimension
40 from ..ingest
import RawExposureData
44 """Strip HDU identifiers from paths and return a unique set of paths. 48 dataRefs : `lsst.daf.persistence.ButlerDataRef` 49 The gen2 datarefs to strip "[HDU]" values from. 54 The unique file paths without appended "[HDU]". 57 for dataRef
in dataRefs:
58 path = dataRef.getUri()
60 paths.add(path.split(
'[')[0])
65 """A specialization of `RepoConverter` for root data repositories. 67 `RootRepoConverter` adds support for raw images (mostly delegated to the 68 parent task's `RawIngestTask` subtask) and reference catalogs. 73 Keyword arguments are forwarded to (and required by) `RepoConverter`. 78 self._exposureData: List[RawExposureData] = []
79 self._refCats: List[Tuple[str, SkyPixDimension]] = []
80 if self.
task.config.rootSkyMapName
is not None:
89 or datasetTypeName
in (
"raw",
"ref_cat",
"ref_cat_config")
91 or datasetTypeName
in self.
task.config.curatedCalibrations
98 def findMatchingSkyMap(self, datasetTypeName: str) -> Tuple[Optional[BaseSkyMap], Optional[str]]:
101 if skyMap
is None and self.
task.config.rootSkyMapName
is not None:
103 (
"Assuming configured root skymap with name '%s' for dataset %s."),
104 self.
task.config.rootSkyMapName, datasetTypeName
107 name = self.
task.config.rootSkyMapName
113 if self.
task.raws
is not None:
114 self.
task.log.info(f
"Preparing raws from root {self.root}.")
115 if self.
subset is not None:
116 dataRefs = itertools.chain.from_iterable(
122 self.
task.log.debug(
"Prepping files: %s", dataPaths)
123 self._exposureData.extend(self.
task.raws.prep(dataPaths))
125 if self.
task.isDatasetTypeIncluded(
"ref_cat")
and len(self.
task.config.refCats) != 0:
126 from lsst.meas.algorithms
import DatasetConfig
as RefCatDatasetConfig
127 for refCat
in os.listdir(os.path.join(self.
root,
"ref_cats")):
128 path = os.path.join(self.
root,
"ref_cats", refCat)
129 configFile = os.path.join(path,
"config.py")
130 if not os.path.exists(configFile):
132 if refCat
not in self.
task.config.refCats:
134 self.
task.log.info(f
"Preparing ref_cat {refCat} from root {self.root}.")
135 onDiskConfig = RefCatDatasetConfig()
136 onDiskConfig.load(configFile)
137 if onDiskConfig.indexer.name !=
"HTM":
138 raise ValueError(f
"Reference catalog '{refCat}' uses unsupported " 139 f
"pixelization '{onDiskConfig.indexer.name}'.")
140 level = onDiskConfig.indexer[
"HTM"].depth
142 dimension = self.
task.universe[f
"htm{level}"]
143 except KeyError
as err:
144 raise ValueError(f
"Reference catalog {refCat} uses HTM level {level}, but no htm{level} " 145 f
"skypix dimension is configured for this registry.")
from err
146 self.
task.useSkyPix(dimension)
147 self._refCats.append((refCat, dimension))
148 if self.
task.isDatasetTypeIncluded(
"brightObjectMask")
and self.
task.config.rootSkyMapName:
154 self.
task.log.info(f
"Inserting observation dimension records from {self.root}.")
155 records = {
"visit": [],
"exposure": [],
"visit_detector_region": []}
156 for exposure
in self._exposureData:
157 for dimension, recordsForDimension
in exposure.records.items():
158 records[dimension].extend(recordsForDimension)
159 self.
task.raws.insertDimensionData(records)
164 for refCat, dimension
in self._refCats:
165 datasetType = DatasetType(refCat, dimensions=[dimension], universe=self.
task.universe,
166 storageClass=
"SimpleCatalog")
168 regex = re.compile(
r"(\d+)\.fits")
169 for fileName
in os.listdir(os.path.join(self.
root,
"ref_cats", refCat)):
170 m = regex.match(fileName)
172 htmId = int(m.group(1))
173 dataId = self.
task.registry.expandDataId({dimension: htmId})
174 yield FileDataset(path=os.path.join(self.
root,
"ref_cats", refCat, fileName),
175 refs=DatasetRef(datasetType, dataId))
177 for begin, end
in self.
subset.skypix[dimension]:
178 for htmId
in range(begin, end):
179 dataId = self.
task.registry.expandDataId({dimension: htmId})
180 yield FileDataset(path=os.path.join(self.
root,
"ref_cats", refCat, f
"{htmId}.fits"),
181 refs=DatasetRef(datasetType, dataId))
186 if self.
task.raws
is not None:
187 self.
task.log.info(f
"Ingesting raws from root {self.root}.")
188 self.
task.registry.registerDatasetType(self.
task.raws.datasetType)
195 for exposure
in self._exposureData:
196 refs.extend(self.
task.raws.ingestExposureDatasets(exposure))
197 for collection
in collections[1:]:
198 self.
task.registry.associate(collection, refs)
203 if datasetTypeName
in self.
task.config.refCats:
def insertDimensionData(self)
def getDataPaths(dataRefs)
def getSpecialDirectories(self)