Exporting Data from Cubeviz#

After data have been manipulated or analyzed, it is possible to export those data back into your Jupyter notebook.

Spatial and Spectral Regions#

See also

Export Spatial Regions

Documentation on how to export spatial regions.

To extract all the subsets created in the viewers, call the Subset Tools plugin:

cubeviz.plugins['Subset Tools'].get_regions()

1D Spectra#

See also

Export Spectra

Documentation on how to export data from the spectrum-viewer.

The following line of code can be used to extract 1D spectra that have been extracted either automatically or manually. To use a function other than sum, use the Spectral Extraction plugin first to create a 1D spectrum and then refer to it by label in get_data.

subset2_spec1d = cubeviz.get_data(data_label="Spectrum (Subset 2, sum)")

3D Data Cubes#

To extract the entire cube, you can run the following code (replace “data_name” with the name of the data you want to extract):

mydata = cubeviz.get_data(data_label="data_name")

The data is returned as a 3D specutils.Spectrum1D object.

To write out a specutils.Spectrum1D cube from Cubeviz (e.g., a fitted cube from Model Fitting), where the mask (if available) is as defined in Spectrum1D masks:

mydata.write("mydata.fits", format="wcs1d-fits", hdu=1)

Model Fits#

For a list of model labels:

models = cubeviz.plugins['Model Fitting'].get_models()
models

Once you know the model labels, to get a specific model:

mymodel = cubeviz.plugins['Model Fitting'].get_models(model_label="ModelLabel", x=10)

To extract all of the model parameters:

myparams = cubeviz.plugins['Model Fitting'].get_model_parameters(model_label="ModelLabel", x=x, y=y)
myparams

where the model_label parameter identifies which model should be returned and the x and y parameters identify specifically which spaxel fits are to be returned, for models applied to every spaxel using the Apply to Cube button. Leaving x or y as None will mean that the models fit to every spaxel across that axis will be returned.

Markers Table#

All mouseover information in the markers plugin can be exported to an astropy table by calling export_table() (see Accessing Plugin APIs).

Aperture Photometry#

Cubeviz can export photometry output table like Imviz through the Aperture Photometry plugin:

results = cubeviz.plugins['Aperture Photometry'].export_table()

See also

Imviz Aperture Photometry

Imviz documentation describing exporting of aperture photometry results in Jdaviz.

In addition to the columns that Imviz Aperture Photometry would provide, the table from Cubeviz has this extra column after data_label:

  • slice_wave: Wavelength value at the selected slice of the cube used for computation. If a 2D data (e.g., collapsed cube) is selected, the value would be NaN instead.