NAME
ftchktablemodel -- checks the validity of a FITS table model file.
USAGE
ftchktablemodel [infile=]filename1 (outfile=logfilename) (clobber=yes/no)
DESCRIPTION
The task performs consistency and keyword checks on an input FITS table model file to determine whether it satisfies the standard, reporting the results to the terminal or to a text log file.
For more information about the standard, see the memo
"The File Format for XSPEC Table Models", OGIP/92-009.
The heasp guide offers instruction on creating table models.
See also the "Adding Models to XSPEC" Appendix in the
Xspec Manual for guidance on using a table model.
What this tool checks
The task checks for extensions, columns, data, mandatory keywords, and optional keywords.
- Spelling and capitalization matter in extension, column, and keyword names.
- Every required exention must be present.
- Every required column must be present.
- The internal data must be consistent according to the standard.
- If an optional keyword is missing, a warning is given.
Fitting Parameters
This tool gives a warning if the table model has more than four fitting parameters. More than three or four fitting parameters is not recommended for memory usage considerations. The memory requirements increase as 2^n where n is the number of parameters in the model.
PARAMETERS
- infile [filename]
- The input file name containing the table model.
- outfile [filename]
- The name of the output log file name. Enter "NONE" for no output file. Precede filename with "!" to clobber.
- (clobber = yes) [boolean]
- Flag specifying whether or not a pre-existing outfile with the same name as that requested as the output file from this task will be overwritten.
EXAMPLES
- ftchktablemodel test-atable.fits
- ftchktablemodel test-atable.fits outfile=test-atable.log
- ftchktablemodel test-atable.fits outfile=test-atable.log clobber=yes
LAST MODIFIED
Jan 2025