CUPID catalogues and masks

The CUPID package (SUN/255) analyzes images and cubes to identify clumps of emission. This analysis results in the production of catalogues that parameterize and quantify the clumps and masks that record which pixels are identified with a clump. There facilities in GAIA for viewing both these data types in images and data-cubes.

Emission in images

To display a 2D catalogue you can simply open it as a local catalogue using the Data-Servers menu. This will display the STC-S shapes described in the catalogue -- these will be ellipses or polygons. You can use the positions and extents of the regions to display rectangles instead of STC-S shapes by importing the catalogue using the Import CUPID catalogue..." toolbox in the Image-Analysis menu.

Import CUPID catalogue

Image masks can be displayed directly as images, or applied to the displayed image using the Mask image..." toolbox in the Image-Analysis menu.

Emission in data-cubes

To display a 3D catalogue you again have two options, open it as a local catalogue, or import it using the Import CUPID catalogue... option in the View menu of the cube toolbox.

If you import it using the cube toolbox then only clumps detected on the current slice will be displayed. If opened as a normal local catalogue the sky positions of all detected clumps will be displayed without any regard to the coordinates of the slice.

To view 3D masks you need to do a full 3D rendering. Catalogues can also be viewed in 3D.

3D rendering

When catalogues are imported using the cube toolbox they can be displayed in 3D as well. In the isophotal and volume rendering toolboxes (View->3D visualisation) there is a CUPID tab. Using that you can request that the catalogue is rendering into the scene (these are shown as prisms, i.e. 2D shapes protruded into the 3rd dimension).

As with imaging 3D masks can be viewed directly or used to select regions from the displayed cube.

Displaying masks directly is best done using the Mask & attributes section in the CUPID controls. To do that select the mask, make sure Display: is selected and press Draw. You can choose mask values to display by entering space separated values in the Values: field, or by entering ranges:

    1-10 20-30


To use the mask to view the associated emission in the data, do as above, but deselect Display: and tick Apply mask: in the main non-tab controls.