Exporting Data from Cubeviz#

Note

This is the config-specific version of documentation and is deprecated. See the general documentation for the most up-to-date information.

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. To use a function other than sum, use the 3D 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.Spectrum object.

To write a specutils.Spectrum cube to disk from Cubeviz (e.g., a fitted cube from Model Fitting), where the mask (if available) is as defined in Spectrum 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 provides, the table from Cubeviz has an extra column after data_label entitled slice_wave that stores the wavelength value at the selected slice of the cube used for computation. If a 2D data (e.g., collapsed cube) is selected, the value will be NaN.