Quickstart

Once installed, jdaviz can be run either as a standalone web application or in a Jupyter notebook.

As a Standalone Application

jdaviz provides a command-line tool to start the standalone desktop application in a browser. To see the syntax and usage, from a terminal, type:

jdaviz --help
jdaviz cubeviz /path/to/data/file

For example, to load a SDSS MaNGA IFU data cube into Cubeviz, you would run the following from a terminal:

jdaviz cubeviz /my/manga/cube/manga-7495-12704-LOGCUBE.fits

In a Jupyter Notebook

The power of jdaviz is that it can integrated into your Jupyter notebook workflow:

from jdaviz import Cubeviz

cubeviz = Cubeviz()
cubeviz.app

jdaviz also provides a directory of sample notebooks to test the application, located in the notebooks sub-directory of the git repository. CubevizExample.ipynb is provided as an example that loads a SDSS MaNGA IFU data cube with the Cubeviz configuration. To run the provided example, start the jupyter kernel with the notebook path:

jupyter notebook /path/to/jdaviz/notebooks/CubevizExample.ipynb

To learn more about the various jdaviz application configurations and loading data, see the Cubeviz, Specviz, Mosviz, or Imviz tools.