Skip to the navigation links
Last modified: 11 September 2018


CalDB 4.8.0 Public Release Notes

Public Release Date: 11 SEP 2018

SDP Installation Date: 2018-09-10T18:22:55 (UTC)


CalDB 4.8.0 is an upgrade to the Chandra CalDB, which includes the following items:

For the CIAO 4.10 / CalDB 4.8.0 release notes see How CalDB 4.8.0 Affects Your Analysis.


A. ACIS T_GAIN Epochs 73+74 (Feb-Jul 2018)

Location: $CALDB/data/chandra/acis/t_gain/
Filename: acisD2017-11-01t_gainN0005.fits

The ACIS Calibration team has released the semiannual time-dependent gain (T_GAIN) updates from analysis of ECS data for the period Feb 01 - Jul 31 2018 (epochs 73+74), and hence the above files have been generated as a result, for immediate release. The secular time variations in the corrections calculated from these new data are similar in magnitude and direction to previous upgrades, wherein maximal changes are a few percent or less of the deltaE/E value. In particular the variations at the ACIS-I aimpoint are significant, whereas those at the ACIS-S aimpoint are very small for this period and the previous epochal period (epochs 71+72, Aug 01 2017 - Jan 31 2018) which is now finalized. NOTE: Users with observations taken between (DATE-OBS=) 2017-11-01T12:00:00 and 2018-05-02T12:00:00 are advised to reprocess with their data with finalized versions of the applicable T_GAIN files.

Users with observations taken since 2018-05-02T12:00:00 will have access to an updated provisional T_GAIN file (one of the version N0002 filenames above); They will not however have a finalized file until after Epoch 76 (Nov 01 2018 - Jan 31 2019) is completed.

For a presentation of the specific values, see the Technical Details Section below. For more information on the ACIS time-dependent gain in general, see the ACIS T_GAIN why page.


ACIS Level 1 pipeline tool acis_process_events.

CIAO script chandra_repro uses acis_process_events to reprocess ACIS observation data.


Reprocessing Data to Create a New Level=2 Event File

B. ACIS T_GAIN N0005 Early Epochs Header Modifications

Location: $CALDB/data/chandra/acis/t_gain/
Filename: acisD2000-01-29t_gainN0005.fits

The ACIS Calibration Team has begun analysis peculiar to their own purposes of External Calibration Source (ECS) data taken with warmer than usual FP_TEMP values; part of their procedure is to reprocess these ERs removing the CTI correction, but having the "apply_tgain" parameter set to "yes", so that a T_GAIN file should still be selected and applied. Ordinarily these ERs are not in GRADED data mode, so that the N0006 (full CTI correction) T_GAIN files are selected for these. With the CTI correcction OFF, CTI_APP = NNNNNNNNNN, and the corresponding N0005 file would be selected. For some of the warmer FP_TEMPs, however, it has been found that the default FP_TEMP boundary condition range was set to (148.2-158.2)K, which for some 24 ERs, a-p-e returns "NO FILES FOUND" for the T_GAIN, and turns off the apply_tgain parameter, leaving the data uncorrected. See Table 1 below.

There were however four additional cases where ERs were taken with normal FP_TEMPs, but still no T_GAIN could be found. It was determined that these cases were at periods crossing the epochal boundaries of the T_GAIN files. The effective date ranges for these cases had been fixed for the usual N0006 (CTI-corrected) T_GAINs in CalDB 4.5.0 (June 2012). See also the CalDB caveats page 38 ACIS OBS_IDs with "Problem Reading TGAINFILE However the corresponding N0005 files had not been corrected for this situation. Hence, turning off the CTI correction causes the T_GAIN CalDB search to fail for them. The solution is to correct the Calibration Validity End Dates CVED* (and Times) CVET* in those N0005 file headers to be the same as those for the corresponding N0006 files.

It has been decided for the sake of consistency that all of the -120C N0005 T_GAIN files from 29 Jan 2000 through 2011 May 01 should have their FP_TEMP ranges reset to (148.2 - 188.2)K, the standard setting used for all current T_GAINs for the OBS_MODE=SECONDARY case, which is the setting for the ACIS ECS ERs. Such a change will not affect the reprocessing of ordinary observations. It will, however, allow the procedure used by the ACIS Calibration team to be performed on any observation (ER or OR), with a non-CTI T_GAIN always being available, regardless of the FP_TEMP, the DATE-OBS, or the DATE-END of the observation.

As always, see the technical details section below for more information on specfic observations.


ACIS Level 1 pipeline tool acis_process_events, with GRADED mode observations taken during the respective effective date ranges of the specific files above. Also with non-GRADED datamode observations provided that the parameter apply_cti is set to "no" while the apply_tgain parameter is set to "yes". Note that in this second case, the CIAO script chandra_repro cannot be used, as it is not possible to turn off the "apply_cti" parameter, because chandra_repro will reset it to "yes" when intializing with your dataset.


No specific CIAO threads are affected.


A. ACIS T_GAIN Epochs 73+74 (Feb-Jul 2018)

The ACIS T_GAIN epoch 73+74, combining two quarterly epochs, and covering the period of Feb 01 through Jul 31, 2018 has recently been completed, and the ACIS External Calibration Source (ECS) radiation zone data has been reduced as per some modified procedures, to generate the time-dependent gain correction tables for this epoch. The procedural modifications were made to address the decreasing statistics available from the ECS due to its natural decay in count rates. The two epochs are being combined to produce a single new T_GAIN correction update.

The original method of derivation for the ACIS T_GAINs is given in the memorandum "Corrections for time-dependence of ACIS gain", posted on ACIS Calibration web page ACIS TGAIN.

The magnitudes (in eV) of the new gain corrections, versus photon energy, are given in Figs. 1-3 below. The secular variations are as follows: Specifically from 5% at ~0.l keV to 1% at ~10 keV for ACIS-I the aim point; for the ACIS-S aim point, the variations are less than 1%. Fig. 1 below gives the corrections for the ACIS-I aimpoint on chip ACIS-3, for the CTI-corrected case, which is the only one applicable to FI chips. Figure 2 gives the corrections for the ACIS-S aimpoint on ACIS-7, for the case where the BI chips are CTI-corrected. Finally Fig. 3 gives the corrections for ACIS-7 for NON-CTI-corrected BI chips. These would be relevant to GRADED DATAMODE observations with ACIS-S, for example.

Fig. 1: Time dependent gain corrections versus photon energy for the ACIS-I aimpoint on ACIS-I3 (CHIPX=970, CHIPY=975) for the new and recent comparable T_GAIN files in CalDB. The parallel CTI correction for the FI chips has been applied to all data.

Fig. 2: Time-dependent gain corrections versus energy for the ACIS-S aimpoint on ACIS-7 (CHIPX=210, CHIPY=520) for the new and recent comparable CalDB T_GAIN files. For these data, the series and parallel CTI correction for the BI chips has been applied.

Fig. 3: T_GAIN correctons versus energy for the ACIS-S aimpoint on ACIS-7, this time with no CTI correction applied to the data, as would be the case for GRADED DATAMODE observations.

Long term trends for chips I3 and S3 are plotted below in Figures 4a and b, through Epoch 73+74, which includes the latest release. The chip locations for these plots are given in the respective labels above the plots. The chip locations selected are near the aimpoints, as with Figs 1 and 2 above. The full CTI correction has been applied to the data in both figures.

Fig. 4a: Long-term T_GAIN correction trends at the ACIS-I3 aimpoint, for specific ECS line energies, from Epoch 1 to Epochs 73+74.
Fig. 4b: Long term T_GAIN correction trends at the aimpoint of ACIS-S3, for specific ECS line energies, from Epoch 1 to Epochs 73+74.

B. ACIS T_GAIN N0005 Early Epochs Header Modifications

Table 1 below includes the 28 specific ECS ERs for which the ACIS Calibration Team had a problem with finding an applicable T_GAIN file with the CTI correction turned off in a-p-e. Included are the FP_TEMP values from the Level 2 events file, as well as the DATE-OBS and DATE-END values. Also included are indicators for whether or not the FP_TEMP value violates the original FP_TEMP boundary condition (148.2-158.2)K, and whether the date range extends over an epochal boundary.

Table 1: ECS ERs used by the ACIS Calibration Team for which the T_GAIN file could not be found for the case where the CTI correction was turned off.
Required N0005 T_GAIN file
61558 158.93457031 Y 2001-07-06T16:36:55 2001-07-06T22:58:52 N acisD2001-05-01t_gainN0005.fits
61521 161.36080933 Y 2001-07-27T22:25:25 2001-07-28T02:46:19 N acisD2001-05-01t_gainN0005.fits
61514 159.58126831 Y 2001-08-04T18:57:37 2001-08-05T01:03:27 N acisD2001-08-01t_gainN0005.fits
61508 161.52267456 Y 2001-08-10T02:48:19 2001-08-10T09:13:06 N acisD2001-08-01t_gainN0005.fits
61112 158.28805542 Y 2002-07-19T20:59:16 2002-07-20T03:09:14 N acisD2002-05-01t_gainN0005.fits
61094 158.44966125 Y 2002-08-04T17:05:42 2002-08-04T23:42:26 N acisD2002-08-01t_gainN0005.fits
60671 158.61128235 Y 2003-07-03T23:00:20 2003-07-04T05:13:06 N acisD2003-05-01t_gainN0005.fits
60653 159.17705536 Y 2003-07-14T16:19:35 2003-07-14T18:41:24 N acisD2003-05-01t_gainN0005.fits
60632 159.09622192 Y 2003-07-19T23:31:04 2003-07-20T01:37:11 N acisD2003-05-01t_gainN0005.fits
60628 158.61128235 Y 2003-07-22T10:42:11 2003-07-22T17:17:01 N acisD2003-05-01t_gainN0005.fits
60599 158.93457031 Y 2003-08-04T15:46:22 2003-08-04T22:14:15 N acisD2003-08-01t_gainN0005.fits
60592 158.61128235 Y 2003-08-10T00:06:32 2003-08-10T06:15:01 N acisD2003-08-01t_gainN0005.fits
59624 158.28805542 Y 2005-06-09T00:07:48 2005-06-09T06:35:47 N acisD2005-05-01t_gainN0005_revA.fits
59619 158.44966125 Y 2005-06-11T15:17:34 2005-06-11T21:12:43 N acisD2005-05-01t_gainN0005_revA.fits
59530 168.41343689 Y 2005-07-26T02:21:31 2005-07-26T08:15:19 N acisD2005-05-01t_gainN0005_revA.fits
59526 164.60037231 Y 2005-07-29T08:48:17 2005-07-29T12:23:51 N acisD2005-05-01t_gainN0005_revA.fits
59519 182.67245483 Y 2005-08-05T17:08:08 2005-08-05T22:08:36 N acisD2005-08-02t_gainN0005.fits
59506 169.46936035 Y 2005-08-13T16:03:52 2005-08-13T18:42:30 N acisD2005-08-02t_gainN0005.fits
59494 158.93457031 Y 2005-08-21T14:25:54 2005-08-21T18:59:03 N acisD2005-08-02t_gainN0005.fits
59414 178.58869934 Y 2005-10-05T12:36:23 2005-10-05T17:23:25 N acisD2005-08-02t_gainN0005.fits
59357 153.60722351 N 2005-10-31T22:33:39 2005-11-01T04:29:30 Y acisD2005-08-02t_gainN0005.fits
58854 157.96488953 N 2006-07-31T19:45:46 2006-08-01T01:40:56 Y acisD2006-05-01t_gainN0005.fits
58719 153.4460144 N 2006-10-31T20:41:23 2006-11-01T01:59:35 Y acisD2006-08-01t_gainN0005.fits
58147 156.34980774 N 2007-10-31T19:24:25 2007-11-01T01:42:14 Y acisD2007-08-01t_gainN0005.fits
57036 159.58126831 Y 2009-06-15T15:05:49 2009-06-15T18:45:22 N acisD2009-05-01t_gainN0005.fits
56997 158.7729187 Y 2009-07-01T11:56:09 2009-07-01T15:39:21 N acisD2009-05-01t_gainN0005.fits
56941 158.61128235 Y 2009-07-22T15:29:02 2009-07-22T19:10:51 N acisD2009-05-01t_gainN0005.fits
56904 158.44966125 Y 2009-08-07T13:06:14 2009-08-07T15:55:54 N acisD2009-08-01t_gainN0005.fits

Table 2 below includes details on the specific header changes made to the 47 N0005 T_GAIN files, including the specific ECS ERs that are affected by those changes. Also included are certain ORs from the CalDB Caveats page given above. For all of the listed ORs, the problem was not in the FP_TEMP value, but in the fact that the observation extended over the T_GAIN epoch time boundary, and needed an extension in the (N0006) T_GAIN file to allow the correct T_GAIN data to be applied. The change put in for the CVED* and CVET* values in CalDB 4.5.0 has now been applied to the corresponding N0005 files.

Table 2: N0005 T_GAIN files that have had their headers altered in the CalDB 4.8.0 release. Included are the specific value changes that have been done in each case.
FILENAME   New CBD2* Value   Old  CVED* Value New  CVED* Value ER(s) OR
acisD2000-01-29t_gainN0005.fits N/A 2000-05-01T00:00:00 2000-05-01T08:00:00 N/A 649
acisD2000-05-01t_gainN0005.fits N/A 2000-08-01T00:00:00 2000-08-01T06:00:00 N/A 79
acisD2000-08-01t_gainN0005.fits N/A 2000-11-01T00:00:00 2000-11-01T15:00:00 N/A 547
acisD2000-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K N/A N/A N/A N/A
acisD2001-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2001-05-01T00:00:00 2001-05-01T05:00:00 N/A 2459
acisD2001-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2001-08-01T00:00:00 2001-08-01T02:00:00 61521, 61558 1982
acisD2001-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K N/A N/A 61514, 61508 N/A
acisD2001-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2002-02-01T00:00:00 2002-02-01T02:00:00 N/A 3436
acisD2002-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2002-05-01T00:00:00 2002-05-01T04:00:00 N/A 3138
acisD2002-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2002-08-01T00:00:00 2002-08-01T04:00:00 61112 2532
acisD2002-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2002-11-01T00:00:00 2002-11-01T01:00:00 61094 3339
acisD2002-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2003-02-01T00:00:00 2003-02-01T01:00:00 N/A 4107
acisD2003-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K N/A N/A N/A N/A
acisD2003-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2003-08-01T00:00:00 2003-08-01T02:00:00 60632, 60628
60671, 60653
acisD2003-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2003-10-19T00:00:00 2003-10-19T02:00:00 60592, 60599 3512
acisD2003-10-19t_gainN0005.fits FP_TEMP(148.2-188.2)K 2003-11-18T00:00:00 2003-11-18T02:00:00 N/A 5011
acisD2003-11-18t_gainN0005.fits FP_TEMP(148.2-188.2)K 2004-01-01T00:00:00 2004-01-01T03:00:00 N/A 4546
acisD2004-01-01t_gainN0005.fits FP_TEMP(148.2-188.2)K N/A N/A N/A N/A
acisD2004-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2004-05-01T00:00:00 2004-05-01T01:00:00 N/A 5142
acisD2004-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K N/A N/A N/A N/A
acisD2004-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2004-11-01T00:00:00 2004-11-01T03:00:00 N/A 4676
acisD2004-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2005-02-01T00:00:00 2005-02-01T15:00:00 N/A 6186
acisD2005-02-01t_gainN0005_revA.fits FP_TEMP(148.2-188.2)K 2005-05-01T00:00:00 2005-05-01T01:00:00 N/A 4537
acisD2005-05-01t_gainN0005_revA.fits FP_TEMP(148.2-188.2)K 2005-08-02T00:00:00 2005-08-02T02:00:00 59526, 59530
59619, 59624
acisD2005-08-02t_gainN0005.fits FP_TEMP(148.2-188.2)K 2005-11-01T00:00:00 2005-11-02T00:00:00 59519, 59506 N/A
acisD2005-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2006-02-01T00:00:00 2006-02-01T03:00:00 N/A 6771
acisD2006-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2006-05-01T00:00:00 2006-05-01T01:00:00 N/A 5932
acisD2006-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2006-08-01T00:00:00 2006-08-02T00:00:00 58854 N/A
acisD2006-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2006-11-01T00:00:00 2006-11-02T00:00:00 58719 N/A
acisD2006-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2007-02-01T00:00:00 2007-02-01T03:00:00 N/A 7910
acisD2007-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2007-05-01T0:00:00 2007-05-01T12:00:00 N/A 7943
acisD2007-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2007-08-01T00:00:00 2007-08-01T14:00:00 N/A 8211
acisD2007-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2007-11-01T00:00:00 2007-11-02T00:00:00 58147 N/A
acisD2007-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2008-02-01T00:00:00 2008-02-01T01:00:00 N/A 7911
acisD2008-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2008-05-01T00:00:00 2008-05-01T09:00:00 N/A 9087
acisD2008-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2008-08-01T00:00:00 2008-08-01T03:00:00 N/A 9892
acisD2008-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K N/A N/A N/A N/A
acisD2008-11-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2009-02-01T00:00:00 2009-02-01T02:00:00 N/A 10118
acisD2009-02-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2009-05-01T00:00:00 2009-05-01T03:00:00 N/A 10464
acisD2009-05-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2009-08-01T00:00:00 2009-08-01T05:00:00 56997, 56941 10808
acisD2009-08-01t_gainN0005.fits FP_TEMP(148.2-188.2)K 2009-11-01T00:00:00 2009-11-01T04:00:00 56904 10459
acisD2010-02-01t_gainN0005.fits N/A 2010-05-01T00:00:00 2010-05-01T06:00:00 N/A 11736
acisD2010-05-01t_gainN0005_revA.fits N/A 2010-08-01T00:00:00 2010-08-01T01:00:00 N/A 11333
acisD2010-08-01t_gainN0005.fits N/A 2010-11-01T00:00:00 2010-11-01T21:00:00 N/A 13158
acisD2010-11-01t_gainN0005.fits N/A 2011-02-01T00:00:00 2011-02-01T03:00:00 N/A 12399
acisD2011-02-01t_gainN0005.fits N/A 2011-05-01T00:00:00 2011-05-01T04:00:00 N/A 12317
acisD2011-05-01t_gainN0005.fits N/A 2011-08-01T00:00:00 2011-08-01T08:00:00 N/A 12891

Note that for the cases where the ER and OR value is set to a bold N/A there is no obsevation to be found that will violate the original FP_TEMP boundary condition, and for these cases it has not been necessary to alter the original CVED* or CVET* values in the headers. Hence, for these files, the FP_TEMP boundary condition change is the only one done, and this was just for consistency's sake.