OGIP Calibration Memo CAL/SAX/95-009

SAX
CALIBRATION FILES
IN THE HEASARC CALDB





edited by:
Ian M George
& Lorella Angelini
Code 668,
NASA/GSFC,
Greenbelt, MD20771
Last Significant Update: 1995 Nov 07
(by IMG)


SUMMARY

The SAX calibration datasets currently in the HEASARC calibration database are described.
NOTE: The datasets in this document were copied from the official SAX Science Data Center (SDC) anonymous ftp site ftp://www.asdc.asi.it. They are provided within the HEASARC calibration database only as a service to US users. All questions/comments regarding their creation/use should be addressed to: helpdesk@sax.sdc.asi.it

LOG OF SIGNIFICANT CHANGES TO THIS DOCUMENT


Release Date Sections Changed Brief Notes
1995 Jul 20 All First Public Release
1995 Oct 10 3.2.1,3.2.2, 3.3.1,3.3.2, 3.4.1,3.4.2, MECS files added & renamed
1995 Nov 07 2.4.2 lecs_alpha.rmf file added
2006 Mar 30 §§ 2.3.1 2.4.1 2.4.2 3.3.1 3.3.2 3.4.1 3.4.2 4.3.1 4.4.1 5.3.1 5.4.1 6.2.1 6.3.1 MFC: changed bcf/responses (which doesn't exist) to cpf/responses (which does); note that some of the ingest dates seem to be out of date with the real CALDB.
2006 May 17 all MFC: made tth compatible with tth

Contents

1  INTRODUCTION
    1.1  Overview
        1.1.1  Contact Person for Scientific Questions/Problems
    1.2  The OGIP Caldb at NASA/GSFC
        1.2.1  Basic Structure
        1.2.2  Calibration Data File Classes
    1.3  Conventions used within this Document
    1.4  Acknowledgments
2  SAX LECS CALIBRATION FILES
    2.1  Summary of Available Files
    2.2  BCF: LECS Background Spectra
        2.2.1  bgd_lecs_nostat_6.pha
    2.3  CPF: Standard LECS Ancillary Response Files
        2.3.1  lecs.arf
    2.4  CPF: Standard LECS Detector Redistribution Matrices
        2.4.1  lecs.rmf
        2.4.2  lecs_alpha.rmf
3  SAX MECS CALIBRATION FILES
    3.1  Summary of Available Files
    3.2  BCF: MECS Background Spectra
        3.2.1  bgd_mecs_nostat_25_jun1995.pha
        3.2.2  bgd_mecs_nostat_25.pha
    3.3  CPF: Standard MECS Ancillary Response Files
        3.3.1  mecs_jun1995.arf
        3.3.2  mecs.arf
    3.4  CPF: Standard MECS Detector Redistribution Matrices
        3.4.1  mecs_jun1995.rmf
        3.4.2  mecs.rmf
4  SAX HPGSPC CALIBRATION FILES
    4.1  Summary of Available Files
    4.2  BCF: HPGSPC Background Spectra
        4.2.1  bgd_hpgspc_nostat.pha
        4.2.2  bgd_hpgspc_#.pha
    4.3  CPF: Standard HPGSPC Ancillary Response Files
        4.3.1  hpgspc.arf
    4.4  CPF: Standard HPGSPC Detector Redistribution Matrices
        4.4.1  hpgspc.rmf
5  SAX PDS CALIBRATION FILES
    5.1  Summary of Available Files
    5.2  BCF: PDS Background Spectra
        5.2.1  bgd_pds_nostat.pha
        5.2.2  bgd_pds_#.pha
    5.3  CPF: Standard PDS Ancillary Response Files
        5.3.1  pds.arf
    5.4  CPF: Standard PDS Detector Redistribution Matrices
        5.4.1  pds.rmf
6  SAX WPC CALIBRATION FILES
    6.1  Summary of Available Files
    6.2  CPF: Standard WFC Ancillary Response Files
        6.2.1  wfc.arf
    6.3  CPF: Standard WFC Detector Redistribution Matrices
        6.3.1  wfc.rmf
7  SAX MISCELLANEOUS CALIBRATION FILES
    7.1  Summary of Available Files

Chapter 1
INTRODUCTION

1.1  Overview

This document is intended to provide a notes on the origin, format, limitations etc of all SAX calibration datasets within the HEASARC calibration database (caldb). By its nature, it is therefore very much a 'live' document and is expected to expand rapidly throughout the In-Orbit Check-out (IOC) and early AO phases of the mission.
In the rest of this chapter, the location and structure of the HEASARC caldb at NASA/GSFC is briefly described, along with references to other relevant documentation. All SAX LECS, MECS, HPGSFC, PDS & WFC datasets within the caldb at NASA/GSFC are then summarized in Chapters 2, 3, 4, 5, & 6 respectfully, with non-instrument specific datasets summarized in Chapter 7

1.1.1  Contact Person for Scientific Questions/Problems

The datasets in this document were copied from the official SAX Science Data Center (SDC) anonymous ftp site www.asdc.asi.it. They are provided within the HEASARC calibration database only as a service to US users.
Scientific questions, problems and comments regarding the contents of the datasets themselves should be addressed to the SAX Science Data Center (SDC) personel via helpdesk@sax.sdc.asi.it

1.2  The OGIP Caldb at NASA/GSFC

The location, organization and contents of the OGIP calibration database on-line at NASA/GSFC is summarized in OGIP Calibration Memo CAL/GEN/93-006.

1.2.1  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).

1.2.2  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). 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.
PLEASE NOTE: The filenames
and locations of the calibration datasets described within this document were chosen by the SAX SDC and/or hardware teams. Please dont complain to the CALDB if you consider them confusing, inappropriate etc.

1.4  Acknowledgments

The information within this document obviously could not have been compiled without the help of very many people within the SAX SDC and instrument teams, 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
SAX LECS CALIBRATION FILES

2.1  Summary of Available Files

The LECS calibration files available under the
/caldb/data/sax/lecs/type
directory tree are listed in Table 2.1. In many cases the actual files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.
Table 2.1: Summary of SAX LECS calibration files available within the OGIP Caldb

Filename Description Section
Basic Calibration Files (type = bcf)
bgd_lecs_nostat_6.pha Background spectrum 2.2.1
Calibration Product Files (type = cpf)
lecs.arf AO-1 ARF 2.3.1
lecs.rmf AO-1 RMF 2.4.1
lecs_alpha.rmf AO-1 RMF 2.4.2

2.2  BCF: LECS Background Spectra

2.2.1  bgd_lecs_nostat_6.pha

Location

caldb/data/sax/lecs/bcf/bgd
Status

CURRENT (Pre-launch)
Summary of File

LECS background spectrum in a 6 arcmin source region (which contains 80% of the power at 0.29 keV).
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

2.3  CPF: Standard LECS Ancillary Response Files

2.3.1  lecs.arf

Location

caldb/data/sax/lecs/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) ARF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

ARFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

2.4  CPF: Standard LECS Detector Redistribution Matrices

2.4.1  lecs.rmf

Location

caldb/data/sax/lecs/cpf/responses
Status

CURRENT (Pre-launch) - but cannot be used on alpha/osf machines (see Points To Note below)
Summary of File

Standard (pre-launch) RMF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

2.4.2  lecs_alpha.rmf

Location

caldb/data/sax/lecs/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) RMF. This file is essentially identical to lecs.rmf described in Section 2.4.1, but with the data underflow problems corrected.
Delivered to CALDB by:

Copied by Lorella Angelini (HEASARC) from SAX SDC 1995 Nov 07.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

Chapter 3
SAX MECS CALIBRATION FILES

3.1  Summary of Available Files

The MECS calibration files available under the
/caldb/data/sax/mecs/type
directory tree are listed in Table 3.1. In many cases the actual files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.
Table 3.1: Summary of SAX MECS calibration files available within the OGIP Caldb

Filename Description Section
Basic Calibration Files (type = bcf)
bgd_mecs_nostat_25_jun1995.pha Background spectrum 3.2.1
bgd_mecs_nostat_25.pha Background spectrum 3.2.2
Calibration Product Files (type = cpf)
mecs_jun1995.arf AO-1 ARF (with error) 3.3.1
mecs.arf AO-1 ARF 3.3.2
mecs_jun1995.rmf AO-1 RMF (with error) 3.4.1
mecs.rmf AO-1 RMF 3.4.2

3.2  BCF: MECS Background Spectra

3.2.1  bgd_mecs_nostat_25_jun1995.pha

Location

caldb/data/sax/mecs/bcf/bgd
Status

SUPERCEDED (See Section 3.2.2)
Summary of File

MECS background spectrum (with 140 PHA channels) in a 2.5 arcmin source region (which contains 80% of the power at 6.4 keV).
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
Between the period 1995 Jul 20 - Oct 10, this dataset was named bgd_mecs_nostat_25.pha within the CALDB. However, on the advice of the SAX team, it was RENAMED to
bgd_mecs_nostat_25_jun1995.pha when an updated file (Section 3.2.2) of the same name was delivered. The CALDB apologises for any confusion this may bring.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

3.2.2  bgd_mecs_nostat_25.pha

Location

caldb/data/sax/mecs/bcf/bgd
Status

CURRENT (Pre-launch)
Summary of File

MECS background spectrum (with 256 PHA channels) in a 2.5 arcmin source region (which contains 80% of the power at 6.4 keV).
Delivered to CALDB by:

Lorella Angelini (HEASARC) 1995 Oct 10, following a visit to the SAX SDC.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

3.3  CPF: Standard MECS Ancillary Response Files

3.3.1  mecs_jun1995.arf

Location

caldb/data/sax/mecs/cpf/responses
Status

SUPERCEDED (see Section 3.3.2)
Summary of File

Standard (pre-launch) ARF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
Between the period 1995 Jul 20 - Oct 10, this dataset was named mecs.arf within the CALDB. However, on the advice of the SAX team, it was RENAMED to mecs_jun1995.arf when an updated file (Section 3.3.2) of the same name was delivered. The CALDB apologises for any confusion this may bring.
File Format

ARFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

3.3.2  mecs.arf

Location

caldb/data/sax/mecs/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) ARF.
Delivered to CALDB by:

Lorella Angelini (HEASARC) 1995 Oct 10, following a visit to the SAX SDC.
File Format

ARFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

3.4  CPF: Standard MECS Detector Redistribution Matrices

3.4.1  mecs_jun1995.rmf

Location

caldb/data/sax/mecs/cpf/responses
Status

SUPERCEDED (see Section 3.4.2)
Summary of File

Standard (pre-launch) RMF, using 140 PHA channels.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
Between the period 1995 Jul 20 - Oct 10, this dataset was named mecs.rmf within the CALDB. However, on the advice of the SAX team, it was RENAMED to mecs_jun1995.rmf when an updated file (Section 3.4.2) of the same name was delivered. The CALDB apologises for any confusion this may bring.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

3.4.2  mecs.rmf

Location

caldb/data/sax/mecs/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) RMF, with 256 PHA channels
Delivered to CALDB by:

Lorella Angelini (HEASARC) 1995 Oct 10, following a visit to the SAX SDC.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

Chapter 4
SAX HPGSPC CALIBRATION FILES

4.1  Summary of Available Files

The HPGSPC calibration files available under the
/caldb/data/sax/hpgspc/type
directory tree are listed in Table 4.1. In many cases the actual files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.
Table 4.1: Summary of SAX HPGSPC calibration files available within the OGIP Caldb

Filename Description Section
Basic Calibration Files (type = bcf)
bgd_hpgspc_nostat.pha Background spectrum 4.2.1
bgd_hpgspc_#.pha Background spectra 4.2.2
Calibration Product Files (type = cpf)
hpgspc.arf AO-1 ARF 4.3.1
hpgspc.rmf AO-1 RMF 4.4.1
None

4.2  BCF: HPGSPC Background Spectra

4.2.1  bgd_hpgspc_nostat.pha

Location

caldb/data/sax/hpgspc/bcf/bgd
Status

CURRENT (Pre-launch)
Summary of File

HPGSPC background spectrum.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

4.2.2  bgd_hpgspc_#.pha

Location

caldb/data/sax/hpgspc/bcf/bgd
Status

CURRENT (Pre-launch)
Summary of Files

Two HPGSPC background spectra, bgd_hpgspc_20.pha & bgd_hpgspc_50.pha, (with statistics on the individual channel bins) appropriate for a 20 ksec & 50 ksec observations respectively.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

4.3  CPF: Standard HPGSPC Ancillary Response Files

4.3.1  hpgspc.arf

Location

caldb/data/sax/hpgspc/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) ARF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

ARFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

4.4  CPF: Standard HPGSPC Detector Redistribution Matrices

4.4.1  hpgspc.rmf

Location

caldb/data/sax/hpgspc/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) RMF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

Chapter 5
SAX PDS CALIBRATION FILES

5.1  Summary of Available Files

The PDS calibration files available under the
/caldb/data/sax/pds/type
directory tree are listed in Table 5.1. In many cases the actual files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.
Table 5.1: Summary of SAX PDS calibration files available within the OGIP Caldb

Filename Description Section
Basic Calibration Files (type = bcf)
bgd_pds_nostat.pha Background spectrum 5.2.1
bgd_pds_#.pha Background spectra 5.2.2
Calibration Product Files (type = cpf))
pds.arf AO-1 ARF 5.3.1
pds.rmf AO-1 RMF 5.4.1
None

5.2  BCF: PDS Background Spectra

5.2.1  bgd_pds_nostat.pha

Location

caldb/data/sax/pds/bcf/bgd
Status

CURRENT (Pre-launch)
Summary of File

PDS background spectrum.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

5.2.2  bgd_pds_#.pha

Location

caldb/data/sax/pds/bcf/bgd
Status

CURRENT (Pre-launch)
Summary of Files

Two PDS background spectra, bgd_pds_20.pha & bgd_pds_50.pha, (with statistics on the individual channel bins) appropriate for a 20 ksec & 50 ksec observations respectively.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

PHAVERSN = 1992a (OGIP/92-007)
Input Datasets, Assumptions, etc

Points to Note

5.3  CPF: Standard PDS Ancillary Response Files

5.3.1  pds.arf

Location

caldb/data/sax/pds/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) ARF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

ARFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

5.4  CPF: Standard PDS Detector Redistribution Matrices

5.4.1  pds.rmf

Location

caldb/data/sax/pds/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) RMF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

Chapter 6
SAX WPC CALIBRATION FILES

6.1  Summary of Available Files

The WFC calibration files available under the
/caldb/data/sax/wfc/type
directory tree are listed in Table 6.1. In many cases the actual files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.
Table 6.1: Summary of SAX WFC calibration files available within the OGIP Caldb

Filename Description Section
Basic Calibration Files (type = bcf))
None
Calibration Product Files (type = cpf))
wfc.arf AO-1 ARF 6.2.1
wfc.rmf AO-1 RMF 6.3.1

6.2  CPF: Standard WFC Ancillary Response Files

6.2.1  wfc.arf

Location

caldb/data/sax/wfc/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) ARF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

ARFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

6.3  CPF: Standard WFC Detector Redistribution Matrices

6.3.1  wfc.rmf

Location

caldb/data/sax/wfc/cpf/responses
Status

CURRENT (Pre-launch)
Summary of File

Standard (pre-launch) RMF.
Delivered to CALDB by:

Copied by Ian M George (HEASARC) from SAX SDC 1995 Jul 20.
File Format

RMFVERSN = 1992a (CAL/GEN/92-002)
Input Datasets, Assumptions, etc

Points to Note

Chapter 7
SAX MISCELLANEOUS CALIBRATION FILES

7.1  Summary of Available Files

The miscellaneous non-instrument specific & s/c-related calibration files available under the
/caldb/data/sax/mis/type
directory tree are listed in Table 7.1. In many cases the actual files will be stored in sub-directories under this tree, as detailed in the corresponding detailed description.
Table 7.1: Summary of SAX 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.73.
On 17 May 2006, 16:46.