Dear all,

I've just pushed a large block of GAIA changes to JAC. To build these you 
will need to clean out GAIA, VTK and Skycat.


Now for what they are about. There are further updates for the VO, in 
particular you can now just query a single SIA service rather than having 
to query a whole list, and there is support for visualising CUPID 
catalogues and masks in 2 and 3D.

From the on-line help (all applies to CUPID outputs, so run FINDCLUMPS on 
a background subtracted image or data-cube):

  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
   boxes instead of STC-S shapes by importing the catalogue using
   the "Import CUPID catalogue..." toolbox in the Image-Analysis
   menu.

   Image masks can be displayed directly as images (naturally), 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 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

    etc.

    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.

Have fun.

Peter.