xcapcon - X windows based capture control function

SYNOPSIS

xcapcon
    [ -display display ] [ -position sxsy ]
    [ -iconic ] [ -icon_position sxsy ]
    [ -fg colorname ] [ -bg colorname ]
    [ -passdir directory ] [ -font fontname ]

DESCRIPTION

xcapcon provides a means to:

View satellite passes and manually schedule them for capture

Display, edit and delete scheduled satellite passes

Display records describing captured satellite passes

Create, edit and delete records defining for automatic scheduling of pass reception.

A pass for a polar orbiting satellite is defined by the period during which the satellite is visible from the receiving site. A pass starts when the satellite first appears above the horizon, and ends when the satellite disappears over the horizon.

A pass for a geostationary satellite refers to a scan of the earth by the onboard sensors. A pass can be a full or partial earth scan, depending on the type of satellite. Normally, passes for geostationary satellites are based on one or more fixed schedules, which can be interchanged based on season or emergency.

xcapcon is based on the same toolkit as xvu, and can be run under either Motif or OpenLook environments.

xcapcon combines the capabilities of a number of command-line functions. See cmdcon for a list of such functions.

CAPTURE CONTROL FILES

xcapcon reports records from four basic files in the pass directory $PASSDIR:

$PASSDIR/autosched: Rules for automatically scheduling pass reception. Rules differ for geostationary and polar orbiting satellites.

$PASSDIR/schedlist: Current list scheduled passes. Passes are deleted from this file as they are processed. This is done by the daemon tsched.

$PASSDIR/onlinecat: List of passes currently online. The maximum number of passes online is determine by the setup file PASSDIR/antenna/BAST.

$PASSDIR/passcat: List of archived passes, which can be extremely large, depending on how long the site has been receiving satellite data.

SETUP FILES

xcapcon uses a number of setup files in the $PASSDIR directory tree:

$PASSDIR/devtable: Defines the archive tape devices supported by the system. xcapcon double checks as to which of these devices actually exists on the system. Each scheduled pass can be automatically archived to a selected device.

$PASSDIR/satlist: Defines which satellites to use in certain popup panels. Satellites are classified as either active or inactive; inactive satellites include those which are no longer transmitting.

$PASSDIR/sitelist: Defines the names and locations of sites which can be used as satellite viewing targets and as pretend receiving sites.

$PASSDIR/postprocs/: Directory of post-processing scripts; each scheduled pass can have an associated post-processing script which is started along with capture.

$PASSDIR/masters/: Directory of master files, which may be used as targets for automatic and manual scheduling of passes. Master files define an area based on a map projection. The center of the area defines the basic target; the size of area determines then length of the (sub)pass required to cover the target.

$PASSDIR/antenna/acctelems: Defines which antennas can receive a given telemetry. This is most useful for sites with multiple antennas controlled by a single host.

RESOURCE OPTIONS

Users may set the following options in their .Xdefaults file. Note that several options involve named colors. These colors must be known the X server, which typically looks up colors by name in the file /usr/lib/X11/rgb.txt.

Display used for user interface panels, plot and image windows. The default is 0:0. Display can be set on the command line using the -display option.

Initial position of the main user interface panel. The default is dependent on the window manager. Format is sxsy, where x denotes the pixel offset in the horizontal direction, y indicates the pixel offset in the vertical direction, and s indicates sign (either + or -). Positive x/y offsets are measured from the left/top of the screen. Negative x/y offsets are measured from the right/bottom of the screen.

Position can be set on the command line using the -position option.

Initial state of the application. If defined, the main user interface panel is iconified. Iconic can be set on the command line using the -iconic option.

Initial position of the icon for the main user interface panel. The default is dependent on the window manager. Icon_Position has the same format as Position. IconPosition can be set on the command line using the -icon_position option.

User interface panel text and highlight color. Default is black. Panel.Foreground can be set on the command line using the -fg option.

User interface panel background color. Default is white. Panel.Background can be set on the command line using the -bg option.

User interface panel text font. Default is 6x13. Recommend only fixed width fonts. Font can be set on the command line using the -font option.

Orbit plot panel foreground color. Default is black.

Orbit plot panel background color. Default is white.

Orbit plot panel window width. Default is half the screen width.

Orbit plot panel window height. Default is half the screen height.

Number of rows in the list of passes on the main panel. The default is 16. The valid range is [4, 32].

The name of the pass directory. Default is $PASSDIR. This parameter can be set on the command line using the -passdir option.

FILES

autosched, onlinecat, passcat, schedlist, devtable, satlist, sitelist