CALDB RELEASE NOTES Version: 2.26 (version 2 update 26) Effective Date: 2004-02-02T21:00:00 For Public Release by 17:00 EST 02-FEB-2004 I. SUMMARY OF CHANGES A. ACIS CONTAM Files Released The ACIS contamination files, versions 1-3, have been approved for release in the CALDB. Versions 1 and 2 are released for archival purposes, and contain the original model developed by H. Marshall of the HETGS team, published in the Summer of 2003. Version 3 contains the newest model, and is the ARDLIB default in this CALDB release, that is, it will be used by mkarf, mkwarf, mkinstmap, and mkgarf to correct for the time-dependent ACIS QE degradation measured from the date of the SSD opening. FILENAMES: acisD1999-08-13contamN0001.fits acisD1999-08-13contamN0002.fits acisD1999-08-13contamN0003.fits Location: $CALDB/data/chandra/acis/bcf/contam/ Affects: CIAO ARFs, GARFs, and exposure maps. B. -120C ACIS-S3 PHA FEFs corrected We discovered a remaining error in the S3 FEF response used in both the non-CTI and the CTI-corrected FEF files (S3 is not calibrated for CTI-correction at this point). This would produce a 1-channel shift when used with CIAO 3.0.2. The new S3 FEF is now free of the 1-channel shift in the RMF generated, regardless of energy range specified. FILENAMES: acisD2000-01-29fef_phaN0004.fits acisD2000-01-29fef_pha_ctiN0003.fits Location: $CALDB/data/chandra/acis/cpf/fefs/ Affects: CIAO mkrmf (ACIS-S3 (BI CHIP) responses) C. ACIS -110C OSIP files upgraded We have widened the acceptance regions in the -110C OSIP files, in particular for the BI chip ACIS-S1, which has the errors in the gain calibration, producing the broad wiggles in plots of grating orders versus wavelength across the array. FILNAMES: acisD1999-09-16osipN0006.fits acisD2000-08-11osipN0006.fits Location: $CALDB/data/chandra/acis/cpf/osip/ Affects: ACIS-S-Grating L1.5 pipeline (tg_resolve_events) D. NOTE: The modified QE_LETG file acisD1997-04-17qeN0004.fits, which was modified using a very early model of the time-dependent QE degradation, which was applied to the ACIS-S chips only, is no longer being distributed with the CALDB as of CALDB 2.26. This file was applicable only to a limited range of data, and is now upstaged by the CONTAM version N0003 model in "A" above. For those who have used the file in the past, it will not be deleted; however future versions of the CALDB will not include it now that the effect being addressed is better quantified. The file made no corrections to ACIS-I, and in future threads and releases, we would like to avoid any confusion therewith. The current ACIS default file, acisD1997-04-17qeN0003.fits, is the one required for use with any of the more recent time-dependent contamination correction routines. II. Technical Details A. ACIS CONTAM Files After some considerable effort, CXC is now able to release into the CALDB three files which model the contamination versus time of the ACIS optical path, which is the proposed explanation of the degradation of the ACIS QE with time. Three files are being released, two of them deprecated in the CALDB but released for archival purposes, and one of them version N0003, which is the new default ACIS CONTAM file in the ARDLIB. Versions N0001 and N0002 contain the original model derived by Herman Marshall and published in the SPIE paper available at the web page http://cxc.harvard.edu/cal/docs/figs/contam.ps entitled "Composition of the ACIS Contaminant." This model includes absorption edge features seen in grating spectra of various cosmic sources, which have been found to vary with time just as the ACIS-QE does. Version N0002 contains the same model, but with an added time point extending the effective date range of the file until the end of 2006. Version N0002 was used to build the Cycle 6 PIMMS and proposal planning ARFs for ACIS. Version 3 contains the new two-level or "fluffium" modeling developed by Dan Dewey of the HETGS team, and is described here: http://space.mit.edu/HETG/technotes/contam/twolevel.html. The new model includes consideration of the External Calibration Source (ECS) time-dependent modeling of the QE degradation, which was used originally to derive the ACISABS/corrarf correction model developed at Penn State. Hence the N0003 model is adjusted to give the flattening with time of the degradation seen in the ECS data. This model is now the recommended time-dependent correction to use with CIAO, and in fact in any analysis of Chandra data, according to the CXC. ACISABS and CONTAMARF, recommended until now, are now deprecated in favor of this model. NOTE: No spatial dependence is yet included in the CONTAM file. That is still a work in progress. Threads affected: "Correcting Responses for ACIS Contamination" http://cxc.harvard.edu/ciao/threads/aciscontam/index.html Includes recommendations for correction ARFs, GARFs, and Exposure Maps. B. ACIS-S3 -120C FEF correction As of CIAO 3.0.2, released 15 DEC 2003, there has been a fix of a software bug in mkrmf. The bug, which produced a one-channel shift in the RMF toward higher energies when the user specified a lower-bound energy that was below the lower limit of the S3 FEF (224.0 eV). From Kenny Glotfelty (CXCDS development team): ------------ "The bug report was that mkrmf produced different grids if the energy range the user supplied was below the minimum energy in FEF vs when the minimum energy was above the FEF grid. When the FEFs in the current release were generated for CALDB 2.7, 08 August 2001, the S3 FEF itself was derived inadvertently with this software error in tow, that is, with the shift being generated in the resultant RMF. Since then, a patch to CIAO 3.0 (version 3.0.2) has been released including the fix to the software. This release has exposed the procedural error in deriving the FEFs in the current release. We seek to correct this procedural error by releasing the corrected S3 FEF data forthwith, in both the CTI-corrected FEF file and in the non-CTI-corrected FEF file. (The FEF files contain FEF data for all 10 chips; S3 is not CTI-corrected at this point, and so the same S3 data go into each FEF table.) From Dick Edgar (ACIS CAL team): Subject: Re: "Description of Change" for FEF corrections From: "Richard J. Edgar" Date: Tue, 27 Jan 2004 11:47:32 -0500 "Up to ciao version 3.0.1, mkrmf had a bug which resulted in an off-by-one error in user-selected PHA channels when the user selected an energy scale which began at an energy lower than the lowest one in the FEF file. When creating the current (CALDB 2.7) S3 FEF, we inadvertently created RMFs for testing which contained this off-by-one error, and so adjusted the gains accordingly to make them fit the known energies of the Al, Ti, and Mn lines in the external calibration source, and oxygen and neon lines in E0102. This bug was fixed with ciao release 3.0.2, (15 Dec 2003). So to generate correct RMF files, the users will need a new S3 FEF file, which we are proposing to release. The centroids of all Gaussians representing lines have been shifted by the requisite number of channels, and validation against the external cal source and E0102 has been performed. The ACIS ad-hoc modeling committee recommends release of this product as soon as possible." NOTE: No change of gain file is necessary for these new FEFs. A simple shift of the channels of the Gaussian centroids was all that was necessary to correct the problem. Threads affected: "Extract ACIS Spectra for Pointlike Sources and Make RMFs and ARFs" http://cxc.harvard.edu/ciao3.0/threads/psextract/ "Step-by-Step Guide to Creating ACIS Spectra for Pointlike Sources: Calculate the RMFs" http://cxc.harvard.edu/ciao3.0/threads/pieces/index.html#rmf "Weighting ARFs and RMFs: multiple sources: Calculate the RMFs" http://cxc.harvard.edu/ciao3.0/threads/wresp_multiple_sources/index.html#wrmf C. ACIS -110C OSIP table We have known for some time that errors in the response function for CHIP ACIS-S1 (ACIS-5) have produced problems in the order-sorting of grating observations, because there appear to be wiggles in the orders as they appear in the S5 range in order-sorting wavelength-vs-TG order plots. We want to widen the acceptance region for ACIS-S1 for the -110C period of 1999-09-16 to 2000-01-29. From Dave H., 21 Jan 2004 memorandum: ftp://space.mit.edu/pub/cxc/Misc/OSIP_update_2004.01.21.ps.gz "I have reprocessed 13 Capella observations with HETG and ACIS-S to review order-sorting quality vs epoch imposed by the OSIP (order sorting and integrated probability) tables. One epoch, 1999-09-16 (ObsIDs 1103, 1318), requires an update because the CalDB OSIP file clips the -1 order for HEG on ACIS-S1. Data were processed with CIAO 3.0.2; no CTI correction was applied (nor is one available for the problem date). After seeing the problem, a few other observations were processed from the same epoch, and also showed the defect (ObsID:Object -- 16:AB Dor; 609: lambda And; 459: 3C273; 605: UX Ari)." [See the figures in the memo and the explanation of the effect.] Dave continues: "To amend the error, I have made a new OSIP file with a widened acceptance region for ACIS-S1..." The input files for the new OSIP are the same as for the old one; there is a notice included in the memo and in the Data Value Verification about the intervening upgrade of the -110C FEF, which is inconsequential to the response data, and to the OSIP. MKGARF uses the OSIP file's FRACRESP column to adjust the effective area vs. wavelength due to the admitance of the grating mask. (Hence not all diffracted photons are admitted into the PHA2 spectra, and the GARF must be appropriately adjusted.) From the file headers, the acceptance limiters and input files used: -- HISTORY CCD_IDs: 4, 5, 6, 7, 8, 9 -- HISTORY N_sigma_lo: -2.5, -7.0, -4.0, -3.5, -4.0, -2.5 -- HISTORY N_sigma_hi: 5.0, 5.0, 6.0, 5.0, 5.0, 2.5 -- HISTORY gain_file: acisD1999-09-16gainN0005.fits -- HISTORY fef_file: acisD1999-09-16fef_phaN0001.fits Threads affected: "Obtain Grating Spectra from (H/L)ETG/ACIS-S Data: Running tg_resolve_events" http://cxc.harvard.edu/ciao/threads/spectra_hetgacis/index.html#tg_resolve_events http://cxc.harvard.edu/ciao/threads/spectra_letgacis/index.html#tg_resolve_events (for -110C ACIS-S/grating observations only)