Import Data

There are two primary ways in which you can load your data into the Cubeviz application. Cubeviz supports loading FITS files that can be parsed as SpectralCube objects, in which case the application will attempt to automatically parse the data into the viewers as described in Displaying Cubes. Cubeviz also supports loading FITS files that can be parsed as Spectrum1D, which will be loaded into the 1D spectrum viewer.

Importing data through the GUI

The first way you can load your data into the Cubeviz application is by clicking the Import button at the top left of the application’s user interface. This opens a dialogue where you can navigate your local file system (single click to enter a folder) and select the path of a file that can be parsed as a SpectralCube or Spectrum1D:

After clicking Import, the data file will be parsed and loaded into the application. A green success message will appear if the data import was successful. Afterward, the new data set can be found in the Data tab of each viewer’s options menu as described in Selecting Data Set.

Importing data via the API

Alternatively, if you are working in a coding environment like a Jupyter notebook, you have access to the Cubeviz helper class API. Using this API, you can load data into the application through code using the load_data() method, which takes as input either the name of a local file or a SpectralCube or Spectrum1D object.

>>> from jdaviz import Cubeviz
>>> cubeviz = Cubeviz()
>>> cubeviz.load_data("/Users/demouser/data/cube_file.fits")