The LSST Science Pipelines¶
The LSST Science Pipelines are designed to enable optical and near-infrared astronomy in the “big data” era. While they are being developed to process the data for the Rubin Observatory Legacy Survey of Space and Time (Rubin’s LSST), our command line and programming interfaces can be extended to address any optical or near-infrared dataset.
This documentation covers version v25_0_2. Learn what’s new. You can also find documentation for other versions.
Getting started¶
If you’re new to the LSST Science Pipelines, these step-by-step data processing tutorials will get you up and running.
Data processing tutorial series (these were developed using the w_2021_33
version of the science pipelines):
Part 1 Data repositories
Part 2 Single frame processing
Part 3 Image and catalog display
Part 4 Global calibration
Part 5 Image coaddition
Part 6 Source measurement
Part 7 Multi-band catalog analysis.
Guide for processing DESC DC2 data in a shared repository using the Alert Production pipeline (this was developed using the w_2021_30
version of the science pipelines):
Join us on the LSST Community forum to get help and share ideas.
Installation¶
Recommended installation path:
Alternative distributions and installation methods:
CernVM FS (contributed by CC-IN2P3)
Related topics:
To install the LSST Simulation software, such as MAF, please follow the LSST Simulations documentation.
Frameworks¶
Python modules¶
- lsst.afw.cameraGeom
- lsst.afw.coord
- lsst.afw.detection
- lsst.afw.display
- lsst.afw.fits
- lsst.afw.formatters
- lsst.afw.geom
- lsst.afw.image
- lsst.afw.math
- lsst.afw.table
- lsst.afw.typehandling
- lsst.alert.packet
- lsst.analysis.tools
- lsst.ap.association
- lsst.ap.pipe
- lsst.ap.verify
- lsst.base
- lsst.cbp
- lsst.coadd.utils
- lsst.cp.pipe
- lsst.ctrl.bps.htcondor
- lsst.ctrl.bps.panda
- lsst.ctrl.bps
- lsst.ctrl.mpexec
- lsst.daf.butler
- lsst.daf.relation
- lsst.dax.apdb
- lsst.display.ds9
- lsst.display.firefly
- lsst.drp.pipe
- lsst.drp.tasks
- lsst.faro.base
- lsst.faro.measurement
- lsst.faro.preparation
- lsst.faro.summary
- lsst.faro.utils
- lsst.faro
- lsst.fgcmcal
- lsst.geom
- lsst.ip.diffim
- lsst.ip.isr
- lsst.jointcal
- lsst.log
- lsst.meas.algorithms
- lsst.meas.astrom
- lsst.meas.base
- lsst.meas.deblender
- lsst.meas.extensions.gaap
- lsst.meas.extensions.photometryKron
- lsst.meas.extensions.piff
- lsst.meas.extensions.psfex
- lsst.meas.extensions.scarlet
- lsst.meas.extensions.shapeHSM
- lsst.meas.extensions.simpleShape
- lsst.meas.extensions.trailedSources
- lsst.meas.modelfit
- lsst.obs.base
- lsst.obs.cfht
- lsst.obs.decam
- lsst.obs.lsst
- lsst.pex.config
- lsst.pex.exceptions
- lsst.pipe.base
- lsst.pipe.tasks
- lsst.resources
- lsst.sconsUtils
- lsst.shapelet
- lsst.skymap
- lsst.utils
- lsst.verify
- lsstDebug
Additional C++ API reference documentation is currently available at the doxygen.lsst.codes site.
Packages¶
Release details¶
- Release History
- Release 25.0.2 (2023-11-17)
- Release 24.1.1 (2023-11-05)
- Release 24.0.0 (2022-12-09)
- Release 23.0.0 (2021-12-21)
- Release 22.0.0 (2021-07-09)
- Release 21.0.0 (2020-12-08)
- Release 20.0.0 (2020-06-24)
- Release 19.0.0 (2019-12-05)
- Release 18.1.0 (2019-08-08)
- Release 18.0.0 (2019-07-09)
- Release 17.0 (2019-02-15)
- Release 16.0 (2018-06-28)
- Release 15.0 (2018-04-06)
- Release 14.0 (2017-10-23)
- Release 13.0 (2017-02-28)
- Release 12.0 (2016-06-15)
- Release 11.0 (2015-09-24)
- Known Issues
- Characterization Metric Reports
Indices¶
Citing and acknowledging the LSST Science Pipelines¶
If you use the science pipelines in a published work, we request that you cite Bosch et al. 2018, 2019. In addition, it is appropriate to include an acknowledgement of the form:
This paper makes use of LSST Science Pipelines software developed by the Vera C. Rubin Observatory. We thank the Rubin Observatory for making their code available as free software at https://pipelines.lsst.io.
For studies that make use of the Data Butler and pipeline execution system, we request that you additionally cite Jenness et al. 2022. For studies that make use of the SCARLET source separation framework, we request that you additionally cite Melchior et al. 2018.
As the Rubin Observatory is not funded to provide support for the LSST Science Pipelines outside of the project, any support provided by project members will come out of their own free or science time. A fair way to acknowledge their help and good will may be to offer co-authorship on technical papers describing the derived software (e.g. pipelines).
License¶
All LSST Science Pipelines code is free software, licensed under the terms of the GNU General Public Licence, Version 3. You have the freedom to run, copy, distribute, study, change and improve the software as you see fit within the terms of the GPL v3 license. Using, modifying or redistributing the LSST Science Pipelines does not make you subject to the LSST Project Publication Policy (LPM-162). This documentation is licensed under the Creative Commons Attribution Share Alike 4.0 International License (CC-BY-SA 4.0).
More info¶
Join us on the LSST Community forum, community.lsst.org.
Fork our code on GitHub at https://github.com/lsst.
Report issues in Jira.
Some API documentation, particularly for C++, is currently published separately on a Doxygen site.
Our Developer Guide describes the procedures and standards followed by the DM team.
Learn more about Rubin Observatory Data Management by visiting http://lsst.org/about/dm.
Contribute to our documentation. This guide is on GitHub at lsst/pipelines_lsst_io.