Getting Started

Documentation

Glish

Learn More

Programming

Contact Us

Version 1.9 Build 1556

News	FAQ
Search	Home

Running gbtlogview

gbtlogview is currently in a state of flux, as AIPS++ versions are evolving. Most of these changes will be transparent to the user in terms of invoking the program. Starting gbtlogview, including setting the various paths, etc, is done by:

scylla<27>% gbtlogview2                         (new version of AIPS++)

or

scylla<27>% gbtlogview2                         (test version of AIPS++)

For those interested in the details, the gbtlogview2 script is the following:

/opt/local/bin/gbtlogview2

#!/opt/local/bin/bash
 
# Starts test version of aips++ GUI for engr logs.  RDN 6/20/96
 
source /aips++/new/aipsinit.sh
# aipsinit _
gbtlogview

The gbtlogview script called by gbtlogview2 is:

gbtlogview : /aips++/new/sun4sol\_gnu/bin/gbtlogview

#!/bin/sh
#
.
.    Copyright comment text has been cut out.
.
#
#   $Id: gbtlogview.tex,v 19.0 2003/07/16 03:48:03 aips2adm Exp $
#-----------------------------------------------------------------------------

# in cv
#INSTALL_PATH=./
# in gb
INSTALL_PATH=/aips++/local/bin

xrdb -merge $INSTALL_PATH/xres
glish -l aips++.g -l gbtlogview.g

This sets up an addition to the X-server resource database and then executes the glish scripts aips++.g and gbtlogview.g (in /aips++/version/sun4sol_gnu/libexec).

After executing 'gbtlogview2', the user is then in the glish environment in the executing window, while a "GBT Log Data" GUI appears (Figure  ). The GUI is intended as the main interface. The frame labeled 'Data Source(s)' has a list of data clients for examination, including various receivers and the local weather station. Each or all of these sources may be selected (by clicking on them with the mouse). The next frame over features several toggle buttons which control the range of selected data. When one of these buttons is selected, for example the "Last Hour" button, information on the start and end time and output table name are automatically obtained. To actually construct a table of values from the selected quantities, the 'Fill' button takes the data from the selected clients and produces a flat table of data records with all of the relevant information. Figure   displays the window that opens to show the filler activity.

Two Data Sources of special note are "Specify Device" and "Specify ASCII table". "Specify Device" allows the user to specify the directory where a non-standard device's data files are stored. Pressing the "Fill" button in this case brings up a frame where you can type the name of the directory (e.g. one can access a normal Rx this way as well, Directory: /GBTlogs/Receivers/RC04_6). It will then grab standard data files according to the time range specified.

"Specify ASCII table" allows the user to specify an ascii table on disk. Pressing the "Fill" button, brings up a frame where you specify the directory and table name (e.g. Directory: /scylla/jmcmulli/ [note the necessary trailing slash], Filename: test.inp). The format of the table must be in the form:

Col1	Col2	Col3	Col4	Col5	Col6	# Column titles
I       I       I       R       R       R       # The format of the column:
                                                #I=int,R=real,A=string
                                                #D=double,X=complex(R,I)
                                                #Z=complex(Amp,phase)
1       4       9       3.45    5.46    7.89    # These are the actual data
2       2       7       2.1     0.1     4       # values.

These two special devices are mutually exclusive.

The 'Browse' button pops up a window with all of the selected data sources' information in table format. The table may be scrolled through with the scroll bars but plotting isn't currently enabled from this window.

The 'Plot Columns' window (Figure  ) has all of the data quantity names in three columns (X, Y, and Y2). Clicking on a quantity selects it for that axis. The 'Plot' button then displays it on the plotter window (Figure  ). Several Y-axis items may be selected for comparison, along with an additional Y2-axis item which will have its axis labeled on the right hand side of the plot.