Provided by: yorick-cubeview_2.2-2.2_all bug

NAME

       cubeview - view 3D FITS files

SYNOPSIS

       cubeview [--pixel[=0/1]] [--stand-alone[=0/1]] [--ui=ui] [file]
       or yorick -i cubeview.i [options] [file]
       or from within yorick(1): cubeview,options or cv_gtk[,options].

DESCRIPTION

       Cubeview  is a 3D data viewer specialized in spectro-imaging, implemented using the Yorick
       interpreted language (see yorick(1)). A 3D data  cube  in  the  sense  of  cubeview  is  a
       three-dimensional array of numbers, usually stored in a FITS file.

       Cubeview  can  function either as a stand-alone viewer for viewing 3D FITS files (in which
       case you don't need to know much about Yorick to use it) or as a Yorick package, in  which
       case  it  is  possible  to  view  Yorick  arrays  directly. Cubeview can be customized and
       enhanced through "hooks" which can automatically perform custom actions while the cube  is
       being  viewed.  For instance, it is possible to overplot some complex contour map over the
       slice view each time it is refreshed. For more details about the cubeview API  in  Yorick,
       read  cubeview.i. When cubeview is launched from a terminal window, it is possible to type
       Yorick commands in that window almost at any time. In the following, this manpage  assumes
       the reader is not a regular Yorick user.

       Since  Cubeview  is specialized in spectro-imaging, it assumes the first two dimensions of
       the cube are of spatial nature while the third is spectral. Cubeview is able to  correclty
       interpret  the FITS headers of data produced with the decommissioned BEAR instrument which
       used to be operated at CFHT and SINFONI currently operated at ESO VLT. Other data  may  be
       interpreted if they follow the same conventions. If the FITS header cannot be interpreted,
       the axes in the plots cannot be trusted, but you can still explore the 3D cube.

       Cubeview uses three windows: a toolbox, a slice image window and a spectrum  plot  window.
       The  toolbox  allows  one  to  open  a new FITS file, save the currently selected sub-cube
       (determined both by the spectrum and slice being viewed), set various display  parameters,
       and perform various actions, most notably selecting a new spectrum or a new slice. If file
       is set in the calling sequence, then all three windows open at once, else only the toolbox
       appears at first, allowing the user to select a file to read.

MAIN PAGE

       The Main page in the toolbox offers reasonably self-explanatory buttons to perform various
       actions. To select a new slice, click on Slice in the Select frame, then  drag  the  mouse
       pointer  over the region of interest in the spectrum window. Conversely, a new sepctrum is
       selected by first clicking Spectrum and then using the mouse in the slice window. How  you
       use  the  mouse  for  selecting  a  spectrum  depends on the Aperture type selected in the
       Spectrum property page:

       Circular
           left button: click to select new center; right button: drag from  new  center  to  new
           edge;

       Square
           left  button:  click  to  select new center; right button: drag from new center to new
           edge;

       Rectangular
           drag from one corner to the opposite.

SPECTRUM PAGE

       The Spectrum property page allows one to select the  Aperture  type  mentioned  above.  In
       addition,  if the FITS header has been interpreted correctly, it is possible to switch the
       spectral axis between Wavelength, Frequency, Channels (raw indices in the cube,  the  only
       meaningful  value  if the header was not interpreted correctly) and Velocity relative to a
       Reference wavelength which can also be set on this page. Smoothing FWHM  controls  whether
       the   displayed   spectrum   should   be   Gaussian-smoothed   to  increase  the  apparent
       signal-to-noise.

SLICE PAGE

       The slice can be displayed in two modes. The most usual one  (named  Normal  (palette)  in
       Cubeview)  is  palette-based.  The  corresponding  Color palette can be selected among the
       standard Yorick  ones.  Alternatively,  Cubeview  can  produce  three-color  images  using
       virtual,  overlapping  red, green and blue filters. The slice can then be displayed either
       at 8 or 24 bit color-depth. 24 bit color depth is usually better, but 8 bit is  useful  to
       save  to some image formats, which you can do from the Yorick command line. Smoothing FWHM
       and Oversampling control two means of smoothing the displayed image for eye candy.

OPTIONS

       --pixel[=(false|true)]
           Control whether the slice window axes are in pixels (true) or in world coordinates  as
           indicated  by  the  CDELT,  CRPIX  and  CRVAL  FITS  cards.  --pixel  is equivalent to
           --pixel=true. The default is true.

       --stand-alone[=(false|true)]
           Control whether closing the toolbox window exits Yorick. --stand-alone  is  equivalent
           to  --stand-alone=true. This is the default for he first form of invocation. If set to
           false, it is necessary to type "quit" at the Yorick  prompt  to  completely  quit  the
           application.

       --ui=(gtk|tws|text)
           Control  the  look-and-feel  of the toolbox. The default toolbox uses the GTK toolkit,
           and requires several software components in addition  to  Yorick  (python,  pygtk  and
           libglade).  An alternative toolbox coded entirely in Yorick is also available. It uses
           the "TWS" package to draw buttons and other widgets. It is uglier, but more  portable,
           than  the  GTK-based  toolbox.  Finally, it is possible to completely control cubeview
           from the Yorick prompt, in "text" mode. Type "cv_library"  for  a  list  of  available
           commands.

SEE ALSO

       yorick(1), cubeview.i

AUTHORS

       Thibaut Paumard <paumard@users.sourceforge.net>

                                            2008-01-03                                CUBEVIEW(1)