lsst.obs.base
20.0.0-34-gdb4d86a+b43b2c05ff
|
Public Member Functions | |
def | __init__ (self, PathElementParser parser) |
def | __str__ (self) |
bool | __call__ (self, str path, str name, Mapping[DatasetType, List[FileDataset]] datasets, *Callable[[DataCoordinate], bool] predicate) |
int | rank (self) |
def | handle (self, str path, dict nextDataId2, Mapping[DatasetType, List[FileDataset]] datasets, *Callable[[DataCoordinate], bool] predicate) |
bool | isForFiles (self) |
Optional[DataCoordinate] | translate (self, dict dataId2, *bool partial=False) |
def | __lt__ (self, PathElementHandler other) |
Public Attributes | |
lastDataId2 | |
An intermediate base class for `PathElementHandler` classes that utilize a `PathElementParser` to match a Gen2 filename template. Parameters ---------- parser : `PathElementParser` An object that matches the path element this handler is responsible for and extracts a (partial) Gen2 data ID from it.
Definition at line 99 of file handlers.py.
def lsst.obs.base.gen2to3.repoWalker.handlers.ParsedPathElementHandler.__init__ | ( | self, | |
PathElementParser | parser | ||
) |
Reimplemented in lsst.obs.base.gen2to3.repoWalker.handlers.SubdirectoryHandler.
Definition at line 109 of file handlers.py.
bool lsst.obs.base.gen2to3.repoWalker.handlers.ParsedPathElementHandler.__call__ | ( | self, | |
str | path, | ||
str | name, | ||
Mapping[DatasetType, List[FileDataset]] | datasets, | ||
*Callable[[DataCoordinate], bool] | predicate | ||
) |
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`, `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.' 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 118 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 132 of file scanner.py.
def lsst.obs.base.gen2to3.repoWalker.handlers.ParsedPathElementHandler.__str__ | ( | self | ) |
Reimplemented in lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler.
Definition at line 115 of file handlers.py.
def lsst.obs.base.gen2to3.repoWalker.handlers.ParsedPathElementHandler.handle | ( | self, | |
str | path, | ||
dict | nextDataId2, | ||
Mapping[DatasetType, List[FileDataset]] | datasets, | ||
*Callable[[DataCoordinate], bool] | predicate | ||
) |
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 133 of file handlers.py.
|
inherited |
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 in lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler, lsst.obs.base.gen2to3.repoWalker.handlers.SubdirectoryHandler, lsst.obs.base.gen2to3.repoWalker.handlers.SkipHandler, and lsst.obs.base.gen2to3.repoWalker.handlers.IgnoreHandler.
Definition at line 64 of file scanner.py.
int lsst.obs.base.gen2to3.repoWalker.handlers.ParsedPathElementHandler.rank | ( | self | ) |
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 128 of file handlers.py.
|
inherited |
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.
Reimplemented in lsst.obs.base.gen2to3.repoWalker.handlers.MultiExtensionFileHandler, lsst.obs.base.gen2to3.repoWalker.handlers.TargetFileHandler, and lsst.obs.base.gen2to3.repoWalker.handlers.SubdirectoryHandler.
Definition at line 110 of file scanner.py.
|
inherited |
Definition at line 59 of file scanner.py.