These Release Notes accompany the release of a patch to FTOOLS 4.1 which updates the RXTE subpackage to v4.1.1. This patch contains upgrades to the PCA background subtraction tools and models which provide a significant improvement in the PCA background subtraction for faint sources. The improvement applies to data from sources fainter than 40 ct/sec/PCU obtained during Epoch 3 (i.e since April 15, 1996). In addition, this patch also provides fixes for several known bugs.
These notes provide details on the changes to PCABACKEST and XTEFILT, and how to run these tools in combination with the two new model files and the SAA History File to obtain the best possible background subtraction for your RXTE data. All other code changes are bug fixes, and are described in the README file.
We envision users applying the background related tools in this Patch in the following way:
Here are the details of the most significant changes to the tools in this patch:
PCABACKEST v2.0c is capable of evaluating two new model components, and is delivered with two corresponding model files. Most of the background is correlated with the "L7" rate, the sum of 7 rates, each of which measures events which trigger exactly two of the signal layers. Unlike the previous particle based models (Q6 or VLE) a plot of X-ray rate vs L7 is single valued; we conclude that a large fraction of the activation background is tracked by this rate.
However, examination of blank sky pointings after the L7 model is removed, show residuals which are correlated with the recent SAA history as measured by the HEXTE particle monitor. A second model component provides an activation related component with halflife of 240 minutes. The driving function is acceptably modelled by the particle monitor integrated dosage per SAA pass, accounting for the 240 minute decay time. Evaluating this component requires access to the complete SAA history (i.e. more data than is contained within any GO data set). This information can be found in the file pca_saa_history_v04 delivered with this patch and valid through May 1998. This file will be updated periodically for later datasets and distributed via the GOF, as information becomes available.
These two new model files produce very good backgrounds for sources fainter than 40 cts/sec/PCU. THEY ARE NOT APPROPRIATE FOR SOURCES BRIGHTER THAN THIS LIMIT. Users with brighter sources should continue to use models from the CALDB or the RXTE PCA team page: http://lheawww.gsfc.nasa.gov/docs/xray/xte/pca/index.html
The new model files are included in this patch. Once the patch is installed, you will find the new models in the $LHEA_DATA directory:
The PCA team is working on models suitable for brighter sources. These models will not require a new version of PCABACKEST, but will require new model files.
XTEFILT has been modified to calculate new quantities useful in filtering data. New filtering criteria based on these quantities result in cleaner data and substantially better backgrounds, when used in conjunction with the new pcabackest.
There have been no changes to the inputs for XTEFILT, however, a new appidlist is *NECESSARY*, and available from the fhelp. Simply type:
fhelp xtefiltand copy the appidlist that appears there into a separate ascii file. Then run XTEFILT as normal, giving the new appidlist in place of any old appid file you may have had. For further details on running xtefilt, see the fhelp or our recipe at:
New Quantities in Filter File:
The following new quantities appear in filter files produced with XTEFILT 1.5:
Recommended Filtering Criteria:
These are the filtering criteria currently recommended by the PCA team to produce clean, low-noise data sets and well-behaved backgrounds. These criteria should be used in MAKETIME with a filter file from the new PCABACKEST to produce Good Time Interval files (GTI files) for input to the RXTE extractors (SAEXTRCT or SEEXTRCT).
The criteria are written in C programming language syntax, which is acceptable input for MAKETIME. They may also be written in FORTRAN syntax; see the fhelp for MAKETIME for details.
Note that these criteria may be ANDed together (&& or .AND.) to produce one long, single input to maketime, or may be used to create separate GTI files for each set of conditions. The separate GTI files can then be given to the extractors at the GTIANDFILE prompt, or the names of the GTI files may be placed in an ascii text file. This text file would then be given at the GTIANDFILE prompt, *preceded* by an "@" sign. See the fhelp for SA- or SEEXTRCT for further information.
To filter out contamination from the SAA:
TIME_SINCE_SAA < 0 || TIME_SINCE_SAA > 30.0This selects time before the SAA passage and times at least 30 minutes after (or whatever number you judge appropriate for your data.)
To filter out electron contamination*:
( ELECTRON0 < 0.1) && ( ELECTRON1 < 0.1 ) && ( ELECTRON2 < 0.1 )* NB: if you will be extracting either of the last two PCU's (3 & 4), add similar electron criteria for these. The above covers only the first three PCU's (0-2).
To filter out Earth occults and bits of slews, plus make sure the PCU's you wish to extract are on*:
( ELV > 10.0 ) && ( OFFSET < 0.02 ) && ( PCU0_ON == 1 ) && ( PCU1_ON == 1 ) && ( PCU2_ON == 1 )* NB: The PCU quantities have a value of "0" when the PCU is off, and "1" when it is on. Include all PCUs you wish to extract in this statement (only PCU's 0-2 are shown in this example). The "OFFSET" parameter above should only be used for pointed observations. Observations which scan across a source or area of sky should not have the "OFFSET < 0.02" criterion applied to them.