Application to browse and generate selections from a catalogue

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

$\ast $ list the columns in a catalogue,

$\ast $ list the parameters and textual information from a catalogue,

$\ast $ 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.

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

$\ast $ 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,

$\ast $ 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,

$\ast $ 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).

catview

Give the name of
the catalogue to be reported.

Enter required action;
HELP for a list of options.

Enter list of columns and
expressions, separated by semi-colons.

Enter the number of
the required selection.

Enter an expression defining the
required selection.

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

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

Enter the required row number in the current
selection.

Enter the first row to be listed in the current selection.

Enter the last row to be listed (0 = last in the current selection).

Enter the name of the output text file.

Enter the name of the output catalogue.

Columns to be saved: true - all
columns; false - only currently chosen.

Save header text from base
catalogue? The permitted responses are: true - save header; false - do not save text.

Enter comments to annotate the new catalogue.

Enter the name of column or parameter.

Enter the
new units for the column or parameter.

Enter the new
external format for the column or parameter.

Enter the screen
width in characters.

Enter the screen height in number of lines.

Should a sequence number be listed with each row?

Enter the number of lines for LIST to output; -1 for them all

Control the way in which angles are displayed. The permitted responses
are: SEXAGESIMAL - sexagesimal hours or degrees, RADIANS - radians.

Reformat the UNITS attribute for angles?

Is the application being run from a GUI?

Flag; is output
file a print file or a data file, coded as follows: .TRUE. - print file, .FALSE. - data file.

Enter the number of lines in a page of output.

Enter the width of line in the output file, in characters.

Include summary in text file? The permitted responses are: A = absent, F =
include summary.

Include column details in text file?
The permitted responses are: A = absent, S = summary only, F = full details.

Include parameter details in text file? The permitted responses are:
A = absent, S = summary only, F = full details.

Include
header text in text file? The permitted responses are: A = absent, F = include full text.

Include data table in text file? The permitted responses are:
A = absent, S = columns only, F = Columns and headings.

Enter list of columns separated by semi-colons.

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.

Enter the name of the file to hold the column statistics.

Give the name of the graphics device.

Enter the title to be displayed on the plot.

Enter
column or expression defining the plot X-axis.

Enter
column or expression defining the plot Y-axis.

Flag; is the
scatter-plot to be auto-scaled?

Minimum value to be plotted
on X axis.

Maximum value to be plotted on X axis.

Minimum value to be plotted on Y axis.

Maximum value to be plotted on Y axis.

Plotting symbol to be used in scatter-plot.

Colour of the
plotting symbols to be used in scatter-plot.

Histogram bin
specification: TRUE - the bins are specified by their width, FALSE - the total number of bins is
specified.

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.

Flag; is the histogram to be normalised?

Operate in quiet mode where warnings are suppressed. The permitted
values are: TRUE - quiet mode, FALSE - verbose mode.

- catselect

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.

Copyright © 2001 Council for the Central Laboratory of the Research Councils