This article describes the various Jdaviz configurations to view different types of spectra. For an explanation on navigating to the Jdaviz analysis tool, visit the page searching for Jdaviz-compatible data.
On this page...
Jdaviz Display Panel
The main display panel contains the Jdaviz python application. Jdaviz has multiple configurations designed to load and view different types of spectroscopic datasets. Which configuration is displayed in the MAST spectral quicklook page depends on the type of data product. See the Icon Nomenclature for quick reference guide to the different Jdaviz configurations. Jdaviz is designed to work generally with data products from many MAST missions. For JWST specifically, see the table JWST Instrument Modes in Jdaviz for a mapping between different JWST datasets and the recommended Jdaviz configuration for viewing the data. Below, we briefly summarize the currently supported Jdaviz configurations available in MAST. For further details, see the Jdaviz documentation homepage.
Each Jdaviz configuration is built from one or more viewers, displaying either a 2d image, a 2d spectrum, or 1d spectrum profile. Each viewer is fully interactive, enabling pan/zoom, subset region selection, image scaling, colormaps, and more. Each configuration also comes equipped with a series of analysis plugins for on-the-fly analysis. Lcviz is a separate application, built on top of Jdaviz, and lightkurve, to display time-series lightcurve data from TESS, Kepler, and K2.
Specviz
The primary configuration for 1d spectroscopic data sets. For JWST these data have x1d and c1d product suffixes. By default, Specviz consists a single 1d spectrum profile viewer (see Figure 1). See Display Spectra on how to manipulate data in the spectrum viewer. See Specviz Analysis Plugins for the types of plugins for spectrum analysis.
Figure 1 — The Jdaviz Specviz configuration, designed to load any 1d spectroscopic data product. By default, it consists of a single 1d spectrum profile viewer.
Specviz2D 
The Specviz2D configuration is used for displaying a 2d spectral image, prior to any spectral extraction step. For JWST these data have s2d product types, associated with the NIRSpec instrument. By default, Specviz2D consists of a 2d spectrum viewer, and a 1d spectrum profile viewer, that are linked together (see Figure 2). See Display Spectra on how to manipulate data in the spectral viewers. See Specviz2D Analysis Plugins for the types of plugins for spectrum analysis.
Specviz2D is meant to display a related 2d and 1d spectroscopic data product for a given target, and thus can accept two data product files as input: a 2d spectrum file, and a 1d spectrum file. When only a single 2d spectrum file is provided, Specviz2D will load the 2d spectrum file into the top 2d viewer, and perform a simple 1d spectral extraction from the 2d file to load into the bottom 1d spectrum profile viewer. This is the default mode in MAST. If you need to load related 2d and 1d spectrum files, download the files locally and load into Specviz2D via Jupyter Lab.
Figure 2 — The Jdaviz Specviz2D configuration, designed to display any related 2d and 1d spectroscopic data. By default, it consists of a single 2d spectrum viewer (top), and 1d spectrum profile viewer (bottom).
Cubeviz 
The primary configuration for 3d spectroscopic data sets, e.g. IFU spectral data cubes. For JWST these data have s3d product types. By default, Cubeviz consists of two image viewers, containing the flux and uncertainty, and a single 1d spectrum profile viewer (see Figure 3). By default, the spectrum viewer is populated by collapsing the spatial axes via a "Sum" into a single spectrum. See Displaying Cubes and Display Spectra on how to manipulate data in the cube and spectral viewers. See Cubeviz Analysis Plugins for the types of plugins for cube analysis.
Figure 3 — The Jdaviz Cubeviz configuration, designed to load 3d spectroscopic data such as IFU spectral datacubes. By default, Cubeviz consists of two image viewers, containing the flux (top left) and uncertainty (top right), and a single 1d spectrum profile viewer (bottom)
Imviz
Imviz is a generalized image viewer for astronomical data (see Figure 4). It accepts the the i2d product type from the Portal. When using Imviz programmatically, you can input a fits file, an NDData object, or a 2D NumPy array.
Figure 4 — The Jdaviz Imviz configuration, designed to display images. By default the image takes up the entire viewer and is fully zoomed. It supports the ability to pan and zoom the image, display pixel and world coordinates, and perform simple aperture photometry on sources.
Lcviz 
Lcviz is a light curve visualization and analysis tool, built on top of Jdaviz and lightkurve, for displaying time-series data (see Figure 5). It primarily supports TESS, Kepler, and K2 lc, slc, and llc data products. See Lcviz Data Analysis Plugins for the types of plugins for time-series analysis.
Figure 5 - The Lcviz application, designed to display time-series lightcurve data from TESS, Kepler, and K2.
Coming soon to the MAST Portal
Not all Jdaviz features are available in the MAST Portal, as they are still being integrated by our software teams. For full functionality, you can always use Jupyter Notebooks or the standalone application.
Mosviz 
The Mosviz configuration is used for multi-object spectroscopy (MOS; see Figure 6). It is was designed to work with the the JWST NIRCam imager and the NIRSpec microshutter assembly. As such, Mosviz has some features that are specific to NIRSpec and NIRCam data. However, it will work with data from any telescope or instrument. Display Spectra is a good guide on how to manipulate data in the spectral viewers. See Mosviz Analysis Plugins for the cube spectrum analysis plugins.
Figure 6 — The Jdaviz Mosviz configuration, designed to display many spectra at once. The default windows are the viewer (top left), a 2D spectrum viewer over a Specviz viewer (top right), and the table viewer (bottom).
For Further Reading...
- Specviz readthedocs, for a more detailed interface overview.
- Jdaviz Documentation
- Lcviz Documentation