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 |eups-tag-bold|. :ref:`Learn what's new <release-latest>`. You can also find documentation for other versions.
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 :doc:`Data repositories <getting-started/data-setup>`
- Part 2 :doc:`Single frame processing <getting-started/singleframe>`
- Part 3 :doc:`Image and catalog display <getting-started/display>`
- Part 4 :doc:`Global calibration <getting-started/uber-cal>`
- Part 5 :doc:`Image coaddition <getting-started/coaddition>`
- Part 6 :doc:`Source measurement <getting-started/photometry>`
- Part 7 :doc:`Multi-band catalog analysis <getting-started/multiband-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.
.. toctree:: :hidden: :caption: Getting Started getting-started/index
Recommended installation path:
- :doc:`Installing with lsstinstall <install/lsstinstall>`
- :doc:`install/setup`
- :doc:`install/top-level-packages`
Alternative distributions and installation methods:
- :doc:`install/docker`
- :doc:`Installing from source with lsstsw <install/lsstsw>`
- CernVM FS (contributed by CC-IN2P3)
Related topics:
To install the LSST Simulation software, such as MAF, please follow the LSST Simulations documentation.
.. toctree:: :hidden: :caption: Installation install/index
.. toctree:: :maxdepth: 2 middleware/index
.. module-toctree::
Additional C++ API reference documentation is currently available at the doxygen.lsst.codes site.
.. package-toctree::
.. toctree:: :maxdepth: 2 releases/index known-issues metrics
.. toctree:: :maxdepth: 1 :hidden: Tasks <tasks>
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).
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).
- 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.