Jdaviz

_images/jdaviz1.svg

jdaviz is a package of astronomical data analysis visualization tools based on the Jupyter platform. These GUI-based tools link data visualization and interactive analysis. They are designed to work within a Jupyter notebook cell, as a standalone desktop application, or as embedded windows within a website – all with nearly identical user interfaces.

jdaviz applications currently include tools for interactive visualization of spectroscopic and imaging data. Imviz is a tool for visualization and quick-look analysis for 2D astronomical images. Specviz is a tool for visualization and quick-look analysis of 1D astronomical spectra. Cubeviz provides a view of spectroscopic data cubes (like those to be produced by JWST MIRI), along with 1D spectra extracted from the cube. Mosviz is a visualization tool for many astronomical spectra, typically the output of a multi-object spectrograph (e.g., JWST NIRSpec), and includes viewers for 1D and 2D spectra as well as contextual information like on-sky views of the spectrograph slit.

Warning

As of jdaviz version 3.5, python 3.8 is no longer supported. Please use python 3.9 or greater to get the latest bug fixes and feature additions for jdaviz.

Note

jdaviz is one tool that is part of STScI’s larger Data Analysis Tools Ecosystem.

Note

The offline version of this documentation can be downloaded from Jdaviz zipped HTML downloads page.

Note

Recordings and instructional notebooks from live Jdaviz tutorials can be found at the JWebbinar website under the “Materials and Videos” expandable section. Scroll down to the bottom of that section to find materials from the most recent session (JWebbinar 24, March 2023).

JWST Instrument Modes in Jdaviz

This tool is designed with instrument modes from the James Webb Space Telescope (JWST) in mind, but the tool should be flexible enough to read in data from many astronomical telescopes. The table below summarizes Jdaviz file support specific to JWST instrument modes.

JWST Instrument Modes in Jdaviz

Instrument

Template Mode

File Type

Pipeline Level

Primary Configuration

NIRSpec

MOS

S2D

2b,3

Mosviz

X1D

2b,3

Specviz

IFU

S3D

2b,3

Cubeviz

X1D

2b,3

Specviz

FS

S2D

2b,3

Specviz2d

X1D

2b,3

Specviz

BOTS

X1DINTS

No Support

NIRISS

IMAGING

I2D

2b,3

Imviz

WFSS

X1D

2b

Specviz

AMI

AMINORM

No Support

SOSS

X1DINTS

No Support

NIRCam

Imaging

I2D

2b,3

Imviz

Coronagraphic Imaging

I2D

2b,3

Imviz

WFSS

X1D

2b

Specviz

Grism TSO

X1DINTS

No Support

MIRI

Imaging

I2D

2b,3

Imviz

Coronagraphic Imaging

I2D

2b,3

Imviz

LRS-slit

S2D

2b,3

Specviz2d

X1D

2b,3

Specviz

LRS-slitless

X1DINTS

No Support

MRS

S3D

2b,3

Cubeviz

X1D

2b, 3

Specviz

Using Jdaviz

Reference/API

Additional documentation

License & Attribution

This project is Copyright (c) JDADF Developers and licensed under the terms of the BSD 3-Clause license.

This package is based upon the Astropy package template which is licensed under the BSD 3-clause licence. See the licenses folder for more information.

Cite jdaviz via our Zenodo record: https://doi.org/10.5281/zenodo.5513927.