Go up one levelGo to Previous Go to Next

The Skycat Application

The skycat application comes in two basic versions:

Actually both versions are interpreting Tcl source code. The difference is in the external environment required.

The single binary version has all of the Tcl source files included as strings in the binary, and so does not require any local Tcl installation or special environment to run. This version is easier to distribute over the net.

The interpreted version, on the other hand, requires a complete Tcl environment, with all of the necessary extensions. This version is practical to use during development or when you want to dynamically load Tcl packages at run-time. This version is started using a symbolic link to a shell script skycat.sh that sets the necessary environment variables and starts skycat_wish , passing it the main skycat.tcl source file. The shell script is generated by the skycat configure script and includes the package path names found at the time configure was run.

In both versions, the application is started by calling SkyCat::startSkyCat (a class procedure). This proc sets up the necessary Tcl environment and creates an instance of the top level SkyCat class. The command line arguments are passed unchanged to the class as options. See Rtd(n) and SkyCat(n) for a detailed description of the options.

Usage:

 
skycat fitsFile
 -option value ...

 

Skycat Command Line Options

Option

Value

Description

-cat

boolean(1 or 0)

Include ESO/Archive catalog extensions (default: 1).

-colorramp_height

height in pixles

Height of colorramp window (default: 12).

-debug

boolean

Debug flag: If true, run background processes in the foreground to ease debugging.

-default_cmap

basename of colormap file

Specify a different default colormap (default: "real"). See the $RTD_LIBRARY/colormap directory for a list of the available colormaps. The option value if the basename of the file.

-default_itt

basename of itt file.

Set the default intensity transfer table. (default: "ramp"). See the $RTD_LIBRARY/colormap directory for a list of the available
files.

-file

file name

Specify a FITS file to load (`-' for stdin). This is the default option, so you can leave off the "-file" part and just specify a file to load.

-float_panel

boolean

If the option value is 1, the skycat info panel is put in a separate popup window, leaving more space for the image window (The default is off).

-min_scale

-max_scale

number

( 2 = zoom 2x

-2 = zoom 1/2x )

Specify the min and max scale values for the Magnification Menu. Negative values shrink the image, positive values zoom in closer. The default values are -10 and 20.

-panel_layout

layout

With this option, you can change the order of the zoom and pan windows in the layout. The default layout is: zoom window on the left, info panel in the center and pan window right. If the layout is specified as saoimage , a layout similar to saoimage is used ( info panel , pan window , zoom window ). If reverse is specified, the order of the windows is the reverse of the default.

-pickobjectorient

vertical,
horizontal

Specify the orientation of the "Pick Object" window. The default is horizontal (panel left, image right). vertical puts the image at top and panel underneath.

-port

port number

Listen for remote commands on the given port (default: 0, which means to choose a port).

-remote

boolean

If -remote 1 is specified and a skycat process is already running, the existing skycat process is sent a message and asked to open a new window and the new skycat process exits immediately. This has the advantage of sharing the image colormap and using fewer system resources, however it depends on being able to use the Tcl send mechanism. For security reasons, Tcl send will not work if you are using xhost based X security. You need to use Xauth security. See the Tcl/Tk Tools book from O'Reilly for more on this topic.

-rtd

boolean

If true, include ESO/VLT Real-Time Features in the Skycat menubar (default: not included).

-scrollbars

boolean

If true, Display horizontal and vertical scrollbars for the image (not displayed by default).

-shm_data

boolean

If true, put image data in sysV shared memory. By default image files are mapped with mmap, not with sysV shared memory.

-shm_header

boolean

If true, put the image header in sysV shared memory (default: 0).

-usexshm

boolean

If true (default), use X shared memory, if available.

-use_zoom_view

boolean

If true (default), use a "view" of the image for the zoom window.

-verbose

boolean

If true, print diagnostic messages for debugging (default: 0).

-with_colorramp

boolean

If true (default), display the color bar.

-with_grid

boolean

If true, include a WCS grid button (default: 0).

-with_pan_window

boolean

If true (default), display the pan window.

-with_zoom_window

boolean

If true (default), display the zoom window.

-zoom_factor

number

Set the zooming factor for the zoom window (default: 4 x).


Go up one levelGo to Previous Go to Next

Please send questions or comments to abrighto@eso.org.
Copyright © 1998 ESO - European Southern Observatory