NAME

<xspec2rdb> - parse an XSPEC log file for designated parameters.

DESCRIPTION

This program parses an XSPEC log file for the desirable parameters (the desirable parameters are listed below) into two /rdb tables. The /rdb tables can be joined by a common `fitid' which shall be generated by the program by concatenating the year-month-day-hour-min-sec.

Note that the program shall parse the first session of a fit. It is the responsibility of the user to output only one fit per log file.

The current list of desirable parameters are:

  1. instrument, runid, detector number, iteration number, noticed channels, file integration time, observed rate, observed_rate_err, model_predicted_rate, model, number of fitted bins, reduced chi-squared.
  2. par number, model component, component, parameter, parameter value, parameter status.

    The parameters given in list 1) shall be outputed to a meta-parameter /rdb table and the parameters given in list 2) shall be ouputed to a fit-parameter /rdb table.

Usage

xspec2rdb [input=?? fitparoutput=?? metaparoutput=?? version+ help+ ]

The options are :

input.

The absolute path to the XSPEC log file to be parsed.

fitparoutput.

The absolute path of the filename where the columns of XSPEC fitted parameters are to be written to.

metaparoutput.

The absolute path of the filename where the meta data of the fit are to be written to.

version.

If version+ then the version number of the program will be written out

item xrcfonly.

If xrcfonly+ then the runid, detector number and iteration number shall be parsed and output to the meta-parameter /rdb table.

help.

help+ causes this message to be written out

If the fitparoutput or the metaparoutput does not exist the appropiate /rdb header shall be written out. If the files already exist then only the parsed output shall be attached a the end of the existing file(s).