CATVIEW

Application to browse and generate selections from a catalogue

Description:

catview is an application for browsing catalogues and selecting subsets from the command line. It provides facilities to:

list the columns in a catalogue,

list the parameters and textual information from a catalogue,

list new columns computed on-the-fly using an algebraic expression defined in terms of existing columns and parameters. For example, if the catalogue contained columns V and B_V (corresponding to the V magnitude and B-V colour) then the B magnitude could be listed by specifying the expression V + B_V.

fast creation of a subset within a specified range for a sorted column,

creation of subsets defined by algebraic criteria. For example, if the catalogue again contained columns V and B_V then to find the stars in the catalogue fainter than twelfth magnitude and with a B-V of greater than 0.5 the criteria would be V > 12.0 .AND. B_V > 0.5,

subsets extracted from the catalogue can be saved as new catalogues. These subsets can include new columns computed from expressions as well as columns present in the original catalogue,

subsets extracted from the catalogue can be saved in a text file in a form suitable for printing, or in a form suitable for passing to other applications (that is, unencumbered with extraneous annotation).

Usage:

catview

Parameters:

CNAME = CHARACTER (read)
Give the name of the catalogue to be reported.
ACTION = CHARACTER (read)
Enter required action; HELP for a list of options.
CMPLST = CHARACTER (read)
Enter list of columns and expressions, separated by semi-colons.
SELNO = INTEGER (read)
Enter the number of the required selection.
EXPR = CHARACTER (read)
Enter an expression defining the required selection.
MINRNG = CHARACTER (read)
Enter minimum value of the required range.

If the column within which the range is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (:). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

+30:00:00.0 degrees (decimal point included in seconds) +30:00:00 degrees (integer number of seconds)

0.5235988 radians

MAXRNG = CHARACTER (read)
Enter maximum value of the required range.

If the column within which the range is being specified is not an angle then simply enter the required value.

If the column is an angle then the value can be entered as either a decimal value in radians or a sexagesimal value in hours or degrees, minutes and seconds. If a sexagesimal value is specified then the hours or degrees, minutes and seconds should be separated by a colon (:). Optionally fractional seconds can be specified by including a decimal point and the required number of places of decimals. An unsigned value is assumed to be in hours and a signed value in degrees (a negative angle cannot be specified in hours). That is, a positive angle in degrees must be preceded by a plus sign.

Examples: any of the following values could be entered to to specify an angle of 30 degrees:

2:00:00.0 hours (decimal point included in seconds) 2:00:00 hours (integer number of seconds)

+30:00:00.0 degrees (decimal point included in seconds) +30:00:00 degrees (integer number of seconds)

0.5235988 radians

ROWNO = INTEGER (read)
Enter the required row number in the current selection.
FIRSTR = INTEGER (read)
Enter the first row to be listed in the current selection.
LASTR = INTEGER (read)
Enter the last row to be listed (0 = last in the current selection).
FLNAME = CHARACTER (read)
Enter the name of the output text file.
CATOUT = CHARACTER (read)
Enter the name of the output catalogue.
CFLAG = LOGICAL (read)
Columns to be saved: true - all columns; false - only currently chosen.
TFLAG = LOGICAL (read)
Save header text from base catalogue? The permitted responses are: true - save header; false - do not save text.
COMM = CHARACTER (read)
Enter comments to annotate the new catalogue.
PNAME = CHARACTER (read)
Enter the name of column or parameter.
UNITS = CHARACTER (read)
Enter the new units for the column or parameter.
EXFMT = CHARACTER (read)
Enter the new external format for the column or parameter.
SWID = INTEGER (read)
Enter the screen width in characters.
SHT = INTEGER (read)
Enter the screen height in number of lines.
SEQNO = LOGICAL (read)
Should a sequence number be listed with each row?
NLIST = INTEGER (read)
Enter the number of lines for LIST to output; -1 for them all
ANGRPN = CHARACTER (read)
Control the way in which angles are displayed. The permitted responses are: SEXAGESIMAL - sexagesimal hours or degrees, RADIANS - radians.
ANGRF = LOGICAL (read)
Reformat the UNITS attribute for angles?
GUI = LOGICAL (read)
Is the application being run from a GUI?
FPRINT = LOGICAL (read)
Flag; is output file a print file or a data file, coded as follows: .TRUE. - print file, .FALSE. - data file.
FPGSZE = INTEGER (read)
Enter the number of lines in a page of output.
FWID = INTEGER (read)
Enter the width of line in the output file, in characters.
FSUMM = CHARACTER (read)
Include summary in text file? The permitted responses are: A = absent, F = include summary.
FCOL = CHARACTER (read)
Include column details in text file? The permitted responses are: A = absent, S = summary only, F = full details.
FPAR = CHARACTER (read)
Include parameter details in text file? The permitted responses are: A = absent, S = summary only, F = full details.
FTXT = CHARACTER (read)
Include header text in text file? The permitted responses are: A = absent, F = include full text.
FTABL = CHARACTER (read)
Include data table in text file? The permitted responses are: A = absent, S = columns only, F = Columns and headings.
CMPSTT = CHARACTER (read)
Enter list of columns separated by semi-colons.
DECPL = INTEGER (read)
Enter the number of decimal places for displaying statistics. Note that this quantity controls only the precision with which the statistics are displayed, not the precision with which they are computed; they are computed as DOUBLE PRECISION numbers.
SFNAME = CHARACTER (read)
Enter the name of the file to hold the column statistics.
GRPHDV = CHARACTER (read)
Give the name of the graphics device.
TITLE = CHARACTER (read)
Enter the title to be displayed on the plot.
XEXPR = CHARACTER (read)
Enter column or expression defining the plot X-axis.
YEXPR = CHARACTER (read)
Enter column or expression defining the plot Y-axis.
AUTOSCL = LOGICAL (read)
Flag; is the scatter-plot to be auto-scaled?
CXMIN = CHARACTER (read)
Minimum value to be plotted on X axis.
CXMAX = CHARACTER (read)
Maximum value to be plotted on X axis.
CYMIN = CHARACTER (read)
Minimum value to be plotted on Y axis.
CYMAX = CHARACTER (read)
Maximum value to be plotted on Y axis.
PLTSYM = CHARACTER (read)
Plotting symbol to be used in scatter-plot.
COLOUR = CHARACTER (read)
Colour of the plotting symbols to be used in scatter-plot.
BINSP = LOGICAL (read)
Histogram bin specification: TRUE - the bins are specified by their width, FALSE - the total number of bins is specified.
BINDET = REAL (read)
The details of the histogram bins. If BINSP is TRUE then BINDET is the width of each bin. If BINSP is FALSE then it is the total number of bins.
NORML = LOGICAL (read)
Flag; is the histogram to be normalised?
QUIET = LOGICAL (read)
Operate in quiet mode where warnings are suppressed. The permitted values are: TRUE - quiet mode, FALSE - verbose mode.

Examples:

catselect
You will be placed in a command prompt where you enter commands to examine the catalogue and generate subsets of it. Type HELP to see a list of commands.

Pitfalls

catview is not really intended to be used interactively and is somewhat terse and inconvenient. If possible you should use the GUI-based catalogue browser xcatview instead. However, xcatview requires an X display and catview may be useful if you do not have one. It may also be useful for running prepared scripts which perform routine, standard, batch type operations.