next up previous contents
Next: Global Options Up: GCX User's Manual Previous: Command Line Options   Contents


Report Converter

The output format of GCX can be converted to a more common tabular form using the -T option. This option uses the value of the .file.tab_format option (File and Device Options/Report converter output format) to specify it's output format. The text below, taken from the on-line help, describes this option.

             Report Converter Format String

The report converter option converts the native gcx output to a
fixed-width tabular format that is easy to import in other programs
for further processing. The table's format is defined by an option
string. The option string consists of tokens separated by spaces.
There are two types of tokens: option tokens, and column tokens.

Options tokens set global table options when present. They can appear
anywhere in the format string.

tablehead        Generate a table header line containing
                   the column titles
collist          Generate a list of columns with position information
                   at the start of the output

res_stats        Generate a line with descriptive statistics on
                   the stars' residuals at the end of each frame.Column tokens specify what information gets output in each column.
The first column token corresponds to the first output column, and so
on in order. Each column token can optionally be followed by a specifier
of the form: width.precision. The width excludes a single character
spacer between the columns. Supported colum tokens are:

name [w]         Output the star's designator
ra [w]           Output the right ascension in h:m:s format
dra [w.p]        Output the right ascension in decimal degrees format
dec [w]          Output the declination in d:m:s format
ddec [w.p]       Output the declination in decimal degrees format
smag [w.p] "<band>" Output the standard magnitude with the given name
serr [w.p] "<band>" Output the error of the standard magnitude
                    with the given name
imag [w.p] "<band>" Output the instrumental magnitude with the given name
ierr [w.p] "<band>" Output the error of the instrumental magnitude
                    with the given name
flags [w]        Output reduction flags and the star type
observation [w]  Output the name of the observation (a synthetic name that
                   can be used to group stars reduced from the same frame
airmass [w.p]    Output the airmass of the observation
jdate [w.p]      Output the Julian date of the observation
mjd [w.p]        Output the modified Julian date of the observation
filter [w]       Output the filter name used for the observation
xc/yc [w.p]      Output the frame coordintes of the star's centroid
xerr/yerr [w.p]  Output the estimated centroiding errors
dx/dy [w.p]      Output the amount the star was moved from it's catalog
                   position when the measuring aperture was centered
residual [w.p]   Output the star's residual in the ensemble solution
stderr [w.p]     Output the star's standard error (residual divided by 
                   the estimated error

Fields for which data is not available are left blank


When converting recipies to AAVSO database format, some fields are obtained
from the recipe and star comments. Tokens of the form <token>=<value> are
searched for. The value is taken for the database field, with underscores and
minus signs converted to spaces. The following tokens are used:

                         Chart comment tokens:

d                AAVSO (Harward) designation of the main var on the chart
s                Original chart scale
t                Latest chart date (MM/YY, YYYY or YYMMDD)
n                Name of the main variable on the chart
w                Who converted the chart
p                Sequence source

                         Star comment tokens:

p                Position source
c                Comments
n                Name of variable star
i                Id of star on chart (if different from v(aavso))



Radu Corlan 2005-01-17