lsst-daf-butler
LSST Data Access framework described in arXiv:2206.14941. Please cite the SPIE paper when using this software.
This is a Python 3 only package (we assume Python 3.11 or higher).
- SPIE paper from 2024: Converting Rubin Observatory's data butler to a client/server architecture (Tech note)
- SPIE Paper from 2022: The Vera C. Rubin Observatory Data Butler and Pipeline Execution System (arXiv) [Primary reference]
- ADASS paper from 2019: Abstracting the Storage and Retrieval of Image Data at the LSST.
- Early design note: DMTN-056
PyPI: lsst-daf-butler
This software is dual licensed under the GNU General Public License (version 3 of the License, or (at your option) any later version, and also under a 3-clause BSD license). Recipients may choose which of these licenses to use; please see the files gpl-3.0.txt and/or bsd_license.txt, respectively.
Arrow Memory Leaks
From version 18 of arrow we have seen significant memory leaks when accessing parquet files using the default memory allocator.
If you see such leaks the workaround is to set the ARROW_DEFAULT_MEMORY_POOL environment variable to jemalloc following the advice from apache/arrow#45882.
For EUPS users this variable is automatically set.
Managing dependencies
This package uses uv to manage the versions of libraries used for CI, Docker builds, and local development.
Upgrading the versions of libraries
Run the following command to refresh uv.lock with the latest available
versions of all libraries:
uv lock --upgrade
Temporarily pinning another LSST package to a development branch
If you are working on a PR that requires unreleased changes from another LSST
repository, you can temporarily pin the new version by opening pyproject.toml
and finding the library in the override-dependencies declaration under
tool.uv. Replace main with the ticket branch, e.g.:
override-dependencies = [
"lsst-utils @ git+https://github.com/lsst/utils@tickets/DM-xxxxx",
...
]
Then run:
uv lock --upgrade-package <package name>
to pull in the updated version for testing, where <package name> is
lsst-utils or whatever package you are overriding.
(You can also just do uv lock --upgrade if you don't mind upgrading all the
other libraries at the same time.)
You will need to re-do this lock update any time you change the code, so that it resolves to the new version.
After the other library's development branch has been merged, reset the
branch to main in pyproject.toml and run the lock update again to pull in
the released version.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file lsst_daf_butler-30.2026.3600.tar.gz.
File metadata
- Download URL: lsst_daf_butler-30.2026.3600.tar.gz
- Upload date:
- Size: 1.3 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9a0f06b6fed934dabc4d46ec25f94cabad61186fa7bb29d8bae7bed6332ea53f
|
|
| MD5 |
77a50fb8bf51a10dae6584857f375db0
|
|
| BLAKE2b-256 |
b0935b2b1edff27740748bc4b1a9e1b2b86a30ee223c73313972e777c2fcf94c
|
File details
Details for the file lsst_daf_butler-30.2026.3600-py3-none-any.whl.
File metadata
- Download URL: lsst_daf_butler-30.2026.3600-py3-none-any.whl
- Upload date:
- Size: 1.4 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c70ffe3c6981e1a3fda9994ac12156875eb9a33a46b18cc6450730c66796b788
|
|
| MD5 |
48644763414238ea8525e1db9907c2e3
|
|
| BLAKE2b-256 |
c44c4da9f3da7b420310faeecd02a76478cfc88a0d534a72610d195e84548d22
|
