OGIP Calibration Memo CAL/EIN/93-017

EINSTEIN
CALIBRATION FILES
IN THE OGIP CALDB

EINSTEIN CALIBRATION FILES IN THE OGIP CALDB

edited by:

http://legacy.gsfc.nasa.gov/docs/bios/imgeorge.html & http://legacy.gsfc.nasa.gov/docs/bios/lbreedon.html

HEASARC
Mail Codes 660.2 & 664,
NASA/GSFC,
Greenbelt, MD20771

Last Update: 1996 Jan 24
(by IMG)

SUMMARY

The calibration datasets currently in the OGIP caldb related to the Einstein Observatory (HEAO-2) are described.

Intended audience: General users, OGIP programmers and authors of data analysis s/w.

LOG OF SIGNIFICANT CHANGES

Release	Sections Changed	Brief Notes
Date

1995 Feb 23	All	Made compatible with `LaTeX2HTML` software
1996 Jan 04	&	one IPC matrix added & one renamed

Chapter 1
INTRODUCTION

1.1 Overview

This document is intended to provide a notes on the origin, format, limitations etc of all EINSTEIN calibration datasets within the http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/caldb_intro.html.

In the rest of this chapter, the location and structure of the http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/caldb_intro.html at http://www.gsfc.nasa.gov/GSFC_homepage.html at is briefly described, along with references to other relevant documentation.

All EINSTEIN XRT, IPC, SSS, HRI, FPCS, OGS & MPC datasets within the caldb at NASA/GSFC are then summarized in Chapters through , with non-instrument specific datasets summarized in Chapter .

1.2 The OGIP Caldb at NASA/GSFC

The location, organization and contents of the http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/caldb_intro.html on-line at NASA/GSFC is summarized in OGIP Calibration Memo CAL/GEN/93-006 (available on-line as ftp://legacy.gsfc.nasa.gov/caldb/docs/memos/cal_gen_93_006/cal_gen_93_006.ps and http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/docs/memos/cal_gen_93_006/cal_gen_93_006.html versions).

1.2.1 Location

The http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/caldb_intro.html is physically located on the (ultrix) legacy machine within the http://heasarc.gsfc.nasa.gov/docs/lhea/homepg_lhea.html at http://www.gsfc.nasa.gov/GSFC_homepage.html

Internet: legacy.gsfc.nasa.gov (128.183.8.233)

within the caldb directory tree. The entire caldb directory tree is available to remote users via ftp://legacy.gsfc.nasa.gov/caldb or gopher://legacy.gsfc.nasa.gov/11/caldb Within the OGIP, the caldb has been remote mounted on all other machines and the symbolic links /caldb & /CALDB created to point to the above top level directory. An identical copy of the caldb is also available on the (VMS) LHEA vax cluster at NASA/GSFC (see CAL/GEN/93-006, available on-line as ftp://legacy.gsfc.nasa.gov/caldb/docs/memos/cal_gen_93_006/cal_gen_93_006.ps and http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/docs/memos/cal_gen_93_006/cal_gen_93_006.html versions).

1.2.2 Basic Structure

The contents of the /caldb area is sub-divided between the following sub-directory trees:

data - containing the calibration dataset directory tree.
software - containing the caltools software tasks, the callib subroutine library and a number of other software-related items.
docs - containing related calibration documentation

Here we only consider the data tree. It should be noted that access to certain caldb directory trees is also available from other areas of the legacy anonymous ftp account via symbolic links (see CAL/GEN/93-006, available on-line as ftp://legacy.gsfc.nasa.gov/caldb/docs/memos/cal_gen_93_006/cal_gen_93_006.ps and http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/docs/memos/cal_gen_93_006/cal_gen_93_006.html versions).

1.2.3 Calibration Data File Classes

The OGIP caldb classifies files as `Primary Calibration Files' `Basic Calibration Files' and `Calibration Product Files' (PCFs, BCFs & CPFs respectively; see also CAL/GEN/91-001, available on-line as ftp://legacy.gsfc.nasa.gov/caldb/docs/memos/cal_gen_91_001/cal_gen_91_001.ps and http://legacy.gsfc.nasa.gov/docs/heasarc/caldb/docs/memos/cal_gen_91_001/cal_gen_91_001.html versions). PCFs are 'raw' ground and in-orbit calibration datasets not of immediate interest to most users as they are not directly required for (all but the most specialized) scientific data analysis tasks. These dataset are not considered here. BCFs contain the lowest level calibration datasets potentially required by downstrem software, and can be considered the `atomic units' of the instrument calibration. CPFs contain `convolutions' of the information stored within BCFs customized for a specific analysis task and/or scientific observation.

All BCF & CPF calibration files are organized using the scheme
/caldb/data/mission/inst where mission & inst are the OGIP-standard names for the mission and instrument. For internal management purposes, a further division into inst/bcf and inst/cpf sub-directories is made in most cases. Non-instrument specific calibration datasets, including general spacecraft housekeeping information etc, can be found in the /caldb/data/mission/mis sub-directory.

1.3 Conventions used within this Document

Throughout this document, the hash (#) symbol is used as a wild-card in filenames to indicate several files are available with slightly different names. In all cases the detailed naming scheme, along with the characters which can be used to replace the # are described in the detailed description of the file set.

1.4 Acknowledgments

The information within this document obviously could not have been compiled without the help of very many people associated with the EINSTEIN project, to whom we owe an enormous debt. Wherever possible we acknowledge the direct source of the information within the text, but undoubtedly this may often under-represent the collective effort involved. We apologise to anybody who has inadvertently not been credited, and will be happy to add their name in the appropriate place(s).

Chapter 2
EINSTEIN XRT CALIBRATION FILES

2.1 Summary of Available Files

The XRT calibration files available under the /caldb/data/einstein/xrt/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 2.1: Summary of EINSTEIN XRT calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
None

Chapter 3
EINSTEIN IPC CALIBRATION FILES

3.1 Summary of Available Files

The EINSTEIN IPC calibration files available under the /caldb/data/einstein/ipc/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 3.1: Summary of EINSTEIN IPC calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
ipc_90jun07_15ch.rsp	Test/simulation 15 channel matrix with nominal gain (BAL=15.15)
ipc_90jun07_16ch.rsp	Test/simulation 16 channel matrix with nominal gain (BAL=15.15)

3.2 CPF: IPC Detector Redistribution Matrices

3.2.1 ipc_90jun07_15ch.rsp

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/ipc/cpf

Summary of File

An on-axis reponse matrix for the IPC assuming a nominal gain (BAL = 15.15) and containing ONLY channels 1-15 (channel zero is missing) for test/simulation purposes (only).

Delivered to CALDB by:

Keith Arnaud (ASCA/XANADU) as the SF file ipc.rsp from XANDEV area. Converted to OGIP FITS 1993 Sep 21 by Ian M George (HEASARC).

File Format

http://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/docs/summary/cal_gen_92_002_summary.html

Input Datasets, Assumptions, etc

Matrix is applicable for a BAL (Bin of ALuminum) of 15.15 only. No further information supplied to the CALDB

Points to Note

Matrix should only be used with PHA datasets corrected to be applicable with a BAL=15.15.
Matrix does NOT include entries for Channel 0 (zero), and hence can only be used with PHA datasets for which this channel as also missing. For this reason, this matrix cannot be used with PHA datasets extracted from Event Lists using XSELECT (the file described in Section should be used instead).
This file was renamed (from ipc_90jun07.rmf) on 1996 Jan 04.

3.2.2 ipc_90jun07_16ch.rsp

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/ipc/cpf

Summary of File

An on-axis reponse matrix for the IPC assuming a nominal gain (BAL = 15.15) and containing all 16 channels (ie channel zero is included, but with a efficiency of zero) for test/simulation purposes (only).

Delivered to CALDB by:

Constructed from ipc_90jun07_16ch.rsp (Section 3.2.1) on 1996 Jan 04 by Ian M George (HEASARC).

File Format

http://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/docs/summary/cal_gen_92_002_summary.html

Input Datasets, Assumptions, etc

Matrix is applicable for a BAL (Bin of ALuminum) of 15.15 only. No further information supplied to the CALDB

Points to Note

Matrix should only be used with PHA datasets corrected to be applicable with a BAL=15.15.

Chapter 4
EINSTEIN SSS CALIBRATION FILES

4.1 Summary of Available Files

The EINSTEIN SSS calibration files available under the /caldb/data/einstein/sss/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 4.1: Summary of EINSTEIN SSS calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
sss_bkgd_v1.pha	Particle/cosmic component to bkgd spectrum
sss_bkgd_v1.cor	Variable component to bkgd spectrum

Calibration Product Files (type = `cpf`)
sss_oe1000.rmf	Detector redistribution matrix (no odd/even effect)
sss_oe1029.rmf	Detector redistribution matrix (odd/even effect applied)

4.2 BCF: Particle/cosmic component to SSS bkgd spectrum

4.2.1 sss_bkgd_v1.pha

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/sss/bcf

Summary of File

Component of the SSS background spectrum related to cosmic ray and particle events.

Delivered to CALDB by:

This dataset was created by Ian M George (HEASARC) using a hacked, private version of the old XANADU programme VIMAT.

File Format

http://heasarc.gsfc.nasa.gov/docs/heasarc/ofwg/docs/summary/ogip_92_007_summary.html

Input Datasets, Assumptions, etc

No further information supplied to the CALDB

Points to Note

there is another, variable component to the SSS background (Section ) which must also be taken into account when performing spectral analysis.

4.3 BCF: Variable component to SSS bkgd spectrum

4.3.1 sss_bkgd_v1.cor

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/sss/bcf

Summary of File

Component of the SSS background spectrum of unknown origin, which is also variable with time.

Delivered to CALDB by:

This dataset was created by Ian M George (HEASARC) using a hacked, private version of the old XANADU programme VIMAT.

File Format

http://heasarc.gsfc.nasa.gov/docs/heasarc/ofwg/docs/summary/ogip_92_007_summary.html

Input Datasets, Assumptions, etc

No further information supplied to the CALDB

Points to Note

there is another, less time-dependent component to the SSS background (Section 4.2.1) which must also be taken into account when performing spectral analysis.

4.4 CPF: SSS Detector Redistribution Matrices

4.4.1 sss_oe1000.rmf

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/sss/cpf

Summary of File

SSS detector redistribution matrix, with NO corrections applied for the odd/even effect.

Delivered to CALDB by:

This dataset was created by Ian M George (HEASARC) using a hacked, private version of the old XANADU programme VIMAT. The basis of this dataset is the binary file:
XANADU:[SPECTRAL.EXOSAT.VIMAT]BSPEC.MAT
as written to the LHEA Vax cluster on 93Mar05. HOWEVER, it should be noted that the values in this file have been divided through by 180.0 compared to those in originally in BSPEC.MAT (which is assumed to be the geometric area of the telescope).

File Format

http://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/docs/summary/cal_gen_92_002_summary.html

Input Datasets, Assumptions, etc

No further information supplied to the CALDB

Points to Note

this dataset does not contain any corrections for the water-ice which build up on the surface of the detector, particularly during the early phases of the mission.
this dataset is a redistribution matrix ONLY. The geometric area of the optics, and effects of vignetting and any water-ice should be taken into account by generating an Ancillary Response File (ARF) appropriate for a given observation.

4.4.2 sss_oe1029.rmf

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/sss/cpf

Summary of File

SSS detector redistribution matrix, with corrections applied for the odd/even effect whereby the original elements in BSPEC.MAT (see below) are multiplied by:

1.000000 - for odd-numbered channels
1.029390 - for even-numbered channels

Delivered to CALDB by:

File Format

http://heasarc.gsfc.nasa.gov/docs/heasarc/caldb/docs/summary/cal_gen_92_002_summary.html

Input Datasets, Assumptions, etc

No further information supplied to the CALDB

Points to Note

this dataset does not contain any corrections for the water-ice which build up on the surface of the detector, particularly during the early phases of the mission.
this dataset is a redistribution matrix ONLY. The geometric area of the optics, and effects of vignetting and any water-ice should be taken into account by generating an Ancillary Response File (ARF) appropriate for a given observation.
a corresponding dataset, but without the above corrections applied for the odd/even effect is also available as described in Section 4.4.1

Chapter 5
EINSTEIN HRI CALIBRATION FILES

5.1 Summary of Available Files

The EINSTEIN HRI calibration files available under the /caldb/data/einstein/hri/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 5.1: Summary of EINSTEIN HRI calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
einhri_90aug03.rmf	Single channel response matrix

5.2 CPF: HRI Detector Redistribution Matrices

5.2.1 einhri_90aug03.rmf

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/hri/cpf

Summary of File

section incomplete

Delivered to CALDB by:

Keith Arnaud 1993 Aug 19, and converted to OGIP FITS by Ian M George (HEASARC) on 1993 Aug 20.

File Format

RMFVERSN = 1992a

Input Datasets, Assumptions, etc

No information supplied to the CALDB

Points to Note

None

Chapter 6
EINSTEIN FPCS CALIBRATION FILES

6.1 Summary of Available Files

The EINSTEIN FPCS calibration files available under the /caldb/data/einstein/fpcs/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 6.1: Summary of EINSTEIN FPCS calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
None

Chapter 7
EINSTEIN OGS CALIBRATION FILES

7.1 Summary of Available Files

The EINSTEIN OGS calibration files available under the /caldb/data/einstein/ogs/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 7.1: Summary of EINSTEIN OGS calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
None

Chapter 8
EINSTEIN MPC CALIBRATION FILES

8.1 Summary of Available Files

The EINSTEIN MPC calibration files available under the /caldb/data/einstein/mpc/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 8.1: Summary of EINSTEIN MPC calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
mpcnew391.rmf	Swank & Christian best matrix
None

8.2 CPF: MPC Detector Redistribution Matrices

8.2.1 mpcnew391.rmf

Location

ftp://legacy.gsfc.nasa.gov/caldb/data/einstein/mpc/cpf

Summary of File

section incomplete

Delivered to CALDB by:

Ian M George (HEASARC) and converted to OGIP FITS 1993 Apr 09.

File Format

RMFVERSN = 1992a

Input Datasets, Assumptions, etc

This matrix was created by Jean Swank & Damien Christian on 1992 Sept 01 and is deemed acceptable for the period when the SSS was operational (1978 day 335 ® 1979 day 280).

HOWEVER, its validity at other times has not been well-proven

No further information currently available to the CALDB.

Points to Note

Matrices have on-axis effective area of the XRT folded in, and thus are ONLY VALID ON AXIS.

Chapter 9
EINSTEIN MISCELLANEOUS CALIBRATION FILES

9.1 Summary of Available Files

The miscellaneous non-instrument specific & s/c-related calibration files available under the /caldb/data/rosat/mis/type directory tree are listed in Table . In many cases the actually files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.

Table 9.1: Summary of EINSTEIN MIS calibration files available within the OGIP Caldb

Filename	Description	Section


Basic Calibration Files (type = `bcf`)
None

Calibration Product Files (type = `cpf`)
None

USEFUL LINKS TO OTHER HTML PAGES

The following useful links are available (in the HTML version of this document only):

File translated from T_EX by T_TH, version 3.84.
On 7 May 2010, 16:13.

EINSTEIN CALIBRATION FILES IN THE OGIP CALDB

SUMMARY

LOG OF SIGNIFICANT CHANGES

Chapter 1 INTRODUCTION

1.1 Overview

1.2 The OGIP Caldb at NASA/GSFC

1.2.1 Location

1.2.2 Basic Structure

1.2.3 Calibration Data File Classes

1.3 Conventions used within this Document

1.4 Acknowledgments

Chapter 2 EINSTEIN XRT CALIBRATION FILES

2.1 Summary of Available Files

Chapter 3 EINSTEIN IPC CALIBRATION FILES

3.1 Summary of Available Files

3.2 CPF: IPC Detector Redistribution Matrices

3.2.1 ipc_90jun07_15ch.rsp

3.2.2 ipc_90jun07_16ch.rsp

Chapter 4 EINSTEIN SSS CALIBRATION FILES

4.1 Summary of Available Files

4.2 BCF: Particle/cosmic component to SSS bkgd spectrum

4.2.1 sss_bkgd_v1.pha

4.3 BCF: Variable component to SSS bkgd spectrum

4.3.1 sss_bkgd_v1.cor

4.4 CPF: SSS Detector Redistribution Matrices

4.4.1 sss_oe1000.rmf

4.4.2 sss_oe1029.rmf

Chapter 5 EINSTEIN HRI CALIBRATION FILES

5.1 Summary of Available Files

5.2 CPF: HRI Detector Redistribution Matrices

5.2.1 einhri_90aug03.rmf

Chapter 6 EINSTEIN FPCS CALIBRATION FILES

6.1 Summary of Available Files

Chapter 7 EINSTEIN OGS CALIBRATION FILES

7.1 Summary of Available Files

Chapter 8 EINSTEIN MPC CALIBRATION FILES

8.1 Summary of Available Files

8.2 CPF: MPC Detector Redistribution Matrices

8.2.1 mpcnew391.rmf

Chapter 9 EINSTEIN MISCELLANEOUS CALIBRATION FILES

9.1 Summary of Available Files

USEFUL LINKS TO OTHER HTML PAGES

Chapter 1
INTRODUCTION

Chapter 2
EINSTEIN XRT CALIBRATION FILES

Chapter 3
EINSTEIN IPC CALIBRATION FILES

Chapter 4
EINSTEIN SSS CALIBRATION FILES

Chapter 5
EINSTEIN HRI CALIBRATION FILES

Chapter 6
EINSTEIN FPCS CALIBRATION FILES

Chapter 7
EINSTEIN OGS CALIBRATION FILES

Chapter 8
EINSTEIN MPC CALIBRATION FILES

Chapter 9
EINSTEIN MISCELLANEOUS CALIBRATION FILES