pcaphasyserr HEADAS help file

NAME

pcaphasyserr - Apply systematic error for PCA spectrum

USAGE

pcaphasyserr myspectrum.pha pculist layerlist [syserrfile=CALDB]

DESCRIPTION

pcaphasyserr applies the PCA team-recommended systematic error to a PCA spectrum.

The user must have an existing PCA spectrum (any data mode). The file is modified in place.

Upon output, the SYS_ERR column is created and is filled with the recommended systematic error due to response uncertainties. Note that this does not include background systematics.

By default, the systematic error file is retrieved from RXTE PCA's Calibration Database (CALDB), although a file name can be specified manually as well.

PARAMETERS

infile [filename]: Name of spectrum file. This file will be modified in place.
pculist [string]: Comma-separated list of PCUs used for the spectrum, or "ALL". Note that this information is not currently used.
layerlist [string]: Comma-separated list of PCA layers used for the spectrum, or "ALL". This information is used to generated a systematic error estimate, weighted by the uncertainties in each layer. The weighting is derived from the spectrum of the Crab.
(syserrfile='CALDB') [filename]: Name of systematic error estimate file, or CALDB.
(cleanup = yes) [boolean]: Clean up scratch files?
(chatter = 2) [int] range 0-5: Verbosity level of output
(clobber = no) [boolean]: Overwrite output file?
(history = yes) [boolean]: Write standard HEADAS parameter history into output file?

EXAMPLES

This example applies systematic error estimates to a spectrum generatd from all PCUs, layer 1 only.

pcaphasyserr myfile.pha ALL 1

This example assumes all layers were used.

pcaphasyserr myfile.pha ALL ALL

CAVEATS

This systematic error estimate is not perfect.

BUGS

Please report problems to xtehelp@athena.gsfc.nasa.gov.