Report Converter
Keywords: gcx

#
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))