JWST Pipeline Notebooks
Jupyter notebooks, a JSON-based interactive Python interface, is a powerful and convenient way to run the JWST pipeline that can be easily configured and shared. This article provides links to a selection of such notebooks that help demonstrate how to reduce JWST data using the JWST Science Calibration Pipeline.
On this page
Curated pipeline notebooks
These notebooks are designed to be easily configurable and allow users to run the JWST pipeline on data from a wide variety of science programs with minimal need for editing while still exposing all of the optional parameters that they might be most interested in modifying for a given instrument mode. These notebooks are also lightweight, running the entire pipeline end-to-end without stepping through individual stages or producing large quantities or intermediate plots, and are thus intended more for day-to-day use than for teaching users about individual pieces of the pipeline. They are actively curated and kept up-to-date with recent versions of the JWST pipeline software.
These notebooks are under development throughout 2024; notebooks for individual observing modes will be added as they become available.
Observing mode | Pipeline version | Notebook link |
---|---|---|
MIRI MRS | 1.13.4 | MRS_FlightNB1.ipynb |
Pipeline caveat notebooks
As discussed in Known Issues with JWST Data, some of the existing JWST data issues can be worked around using dedicated offline notebooks while awaiting long-term pipeline fixes. The majority of these notebooks are located in the jwst-caveat-examples GitHub repository, although some are maintained in alternate locations. The best way to discover these notebooks is through the tables of common issues and workarounds on the known issues articles for each JWST instrument mode.
JDAT and Jdaviz notebooks
Multiple notebooks have been made available for post-pipeline analysis and inspection of JWST data products. These notebooks do not focus on running the JWST pipeline, but rather on working with the data products that it produces. See JWST Post-Pipeline Data Analysis for further details.
Outdated notebooks
Many demonstration notebooks were produced early in the JWST mission (many in the context of JWebbinars) to introduce the community to the JWST data products, pipeline structure, and individual steps therein. While the notebooks below are no longer maintained and may no longer reflect the latest JWST pipeline environment, they can nonetheless be an excellent place to get started in learning about the pipeline and the data products that it produces.
Outdated data product notebooks
Notebook (in PDF and Github) | Content | Video demonstration (when available) |
---|---|---|
Using an uncalibrated (raw) JWST exposure:
| ||
Using JWST datamodels:
| ||
Using the final data products from the pipeline:
|
Outdated pipeline notebooks
Notebook in PDF and Github version | Content | Video demonstration |
---|---|---|
Working with the stage 1 calibration pipeline:
| ||
Working with the stage 2 calibration pipeline for Imaging:
| ||
Working with the stage 3 calibration pipeline for imaging:
| w | |
Working with the stage 2 calibration pipeline for spectroscopy:
| ||
Working with the stage 3 calibration pipeline for spectroscopy:
|