lsst.obs.base
21.0.0-27-gbbd0d29+ae871e0f33
|
Public Member Functions | |
def | __init__ (self, PathElementParser parser, Translator translator, DatasetType datasetType, FormatterParameter formatter=None) |
def | __str__ (self) |
bool | isForFiles (self) |
def | handle (self, str path, nextDataId2, Mapping[DatasetType, Mapping[Optional[str], List[FileDataset]]] datasets, *Callable[[DataCoordinate], bool] predicate) |
Tuple[Optional[DataCoordinate], Optional[str]] | translate (self, dict dataId2, *bool partial=False) |
bool | __call__ (self, str path, str name, Mapping[DatasetType, Mapping[Optional[str], List[FileDataset]]] datasets, *Callable[[DataCoordinate], bool] predicate) |
int | rank (self) |
def | handle (self, str path, dict nextDataId2, Mapping[DatasetType, Mapping[Optional[str], List[FileDataset]]] datasets, *Callable[[DataCoordinate], bool] predicate) |
def | __lt__ (self, PathElementHandler other) |
Public Attributes | |
lastDataId2 | |
A `PathElementHandler` that matches files that correspond to target datasets and outputs `FileDataset` instances for them. Parameters ---------- parser : `PathElementParser` An object that matches the path element this handler is responsible for and extracts a (partial) Gen2 data ID from it. translator : `Translator` Object that translates data IDs from Gen2 to Gen3. datasetType : `lsst.daf.butler.DatasetType` Gen3 dataset type for the datasets this handler matches. formatter : `lsst.daf.butler.Formatter` or `str`, optional A Gen 3 formatter class or fully-qualified name.
Definition at line 264 of file handlers.py.
def lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler.__init__ | ( | self, | |
PathElementParser | parser, | ||
Translator | translator, | ||
DatasetType | datasetType, | ||
FormatterParameter | formatter = None |
||
) |
Definition at line 280 of file handlers.py.
|
inherited |
Apply the handler to a file path. Parameters ---------- path : `str` Full path of the file or directory. name : `str` Local name of the file or directory within its parent directory. datasets : `dict` [`DatasetType`, `dict` ] Dictionary that found datasets should be added to. Nested dicts are keyed by either `None` (for most datasets) or a `str` "CALIBDATE" for calibration datasets. predicate : `~collections.abc.Callable` A callable taking a single `DataCoordinate` argument and returning `bool`, indicating whether that (Gen3) data ID represents one that should be included in the scan.' Returns ------- matched : `bool` `True` if this handler was a match for the given path and no other handlers need to be tried on it, `False` otherwise.
Reimplemented from lsst.obs.base.gen2to3.repoWalker.scanner.PathElementHandler.
Definition at line 120 of file handlers.py.
|
inherited |
Handlers are sorted by rank to reduce the possibility that more flexible handlers will have a chance to match something they shouldn't.
Definition at line 140 of file scanner.py.
def lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler.__str__ | ( | self | ) |
Reimplemented from lsst.obs.base.gen2to3.repoWalker.handlers.ParsedPathElementHandler.
Definition at line 289 of file handlers.py.
|
inherited |
Customization hook for ``__call__``. Subclasses must override this method, while external callers (i.e. `DirectoryScanner` should instead invoke `__call__`. Parameters ---------- path : `str` Full path of the file or directory. nextDataId2 : `dict` Gen2 data ID (usually partial) extracted from the path so far. datasets : `dict` [`DatasetType`, `list` [`FileDataset`] ] Dictionary that found datasets should be added to. predicate : `~collections.abc.Callable` A callable taking a single `DataCoordinate` argument and returning `bool`, indicating whether that (Gen3) data ID represents one that should be included in the scan. formatterMap : `dict`, optional Map dataset type to specialist formatter.
Reimplemented in lsst.obs.base.gen2to3.repoWalker.handlers.SkipHandler.
Definition at line 136 of file handlers.py.
def lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler.handle | ( | self, | |
str | path, | ||
nextDataId2, | |||
Mapping[DatasetType, Mapping[Optional[str], List[FileDataset]]] | datasets, | ||
*Callable[[DataCoordinate], bool] | predicate | ||
) |
Reimplemented in lsst.obs.base.gen2to3.repoWalker.handlers.MultiExtensionFileHandler.
Definition at line 296 of file handlers.py.
bool lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler.isForFiles | ( | self | ) |
Report what kind of path element this object handlers. Returns ------- Return `True` if this handler is for file entries, or `False` if it is for directories.
Reimplemented from lsst.obs.base.gen2to3.repoWalker.scanner.PathElementHandler.
Definition at line 292 of file handlers.py.
|
inherited |
Return a rough indication of how flexible this handler is in terms of the path element names it can match. Handlers that match a constant path element should always return zero.
Reimplemented from lsst.obs.base.gen2to3.repoWalker.scanner.PathElementHandler.
Definition at line 131 of file handlers.py.
Tuple[Optional[DataCoordinate], Optional[str]] lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler.translate | ( | self, | |
dict | dataId2, | ||
*bool | partial = False |
||
) |
Translate the given data ID from Gen2 to Gen3. The default implementation returns `None`. Subclasses that are able to translate data IDs should override this method. Parameters ---------- dataId2 : `dict` Gen2 data ID. partial : `bool`, optional If `True` (`False` is default) this is a partial data ID for some dataset, and missing keys are expected. Returns ------- dataId3 : `lsst.daf.butler.DataCoordinate` or `None` A Gen3 data ID, or `None` if this handler cannot translate data IDs. calibDate : `str` or `None` A Gen2 calibration "CALIBDATE" value, or `None` if there was no such value in the template.
Reimplemented from lsst.obs.base.gen2to3.repoWalker.scanner.PathElementHandler.
Reimplemented in lsst.obs.base.gen2to3.repoWalker.handlers.MultiExtensionFileHandler.
Definition at line 309 of file handlers.py.
|
inherited |
Definition at line 60 of file scanner.py.