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 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: 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

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

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

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

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

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:
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

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

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

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 TEX by TTH, version 3.84.
On 7 May 2010, 16:13.