Location¶

class lsst.daf.butler.Location(datastoreRootUri, path)¶

Bases: object

Identifies a location within the Datastore.

Parameters:	datastoreRootUri : `ButlerURI` or `str` Base URI for this datastore, must include an absolute path. path : `str` Relative path within datastore. Assumed to be using the local path separator if a `file` scheme is being used for the URI, else a POSIX separator.

Attributes Summary

`path`	Path corresponding to location.
`pathInStore`	Path corresponding to location relative to `Datastore` root.
`uri`	URI string corresponding to fully-specified location in datastore.

Methods Summary

updateExtension(ext) Update the file extension associated with this Location.

Attributes Documentation

path¶

Path corresponding to location.

This path includes the root of the Datastore, but does not include non-path components of the root URI. If a file URI scheme is being used the path will be returned with the local OS path separator.

pathInStore¶

Path corresponding to location relative to Datastore root.

Uses the same path separator as supplied to the object constructor.

uri¶: URI string corresponding to fully-specified location in datastore.

Methods Documentation

updateExtension(ext)¶

Update the file extension associated with this Location.

Parameters:	ext : `str` New extension. If an empty string is given any extension will be removed. If `None` is given there will be no change.

Navigation

Location¶