Next: 6. High-Level OSSE Spectral Up: OSSE Pipeline Documentation Previous: 4. Things Your Mother

Subsections

5. OSSE Data Files

5.1 Low-Level Spectral Database Files

5.1.1 Introduction

The OSSE Spectral Database Files (SDB) are VAX/VMS indexed files with variable length records. Each record can be one of a multiple of `types', called AUX-types. Each AUX-type contains a specific type of information and individual SDB files can contain more than one AUX-type.

5.1.2 Spectral Memory File

File Name Format:
Pyyddd0000_SPM.SDB
Product Type:
Low-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Contents:
Raw primary detector count spectra, generally two minute sums. Source and background pointing for an entire day of observations. Spectra are stored as I*4 arrays.
Archived?:
Yes. pyyddd000_spm.fits
AUX Record Types:

DAT 0 spectral counts
CAL_LINE 25 Calibration line information
ORBHIST 29 Orbit history information

5.1.3 Shield Data

File Name Format:
Pyyddd0000_BURST.SDB
Product Type:
Low-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Contents:
4096 time bins measured from the shields. The time resolution is adjustable down to 4 milliseconds. These are stored as I*4.
Archived?:
Yes. pyyddd000_burst.fits
AUX Record Types:

DAT 0 spectral counts (long integer & Reals)
MULTI_SPEC_DSF 19 burst spectrum?
SDB_DIR 42 SDB directory

5.1.4 Cobalt 60 Spectra

File Name Format:
Pyyddd0000_C60.SDB
Product Type:
Low-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Contents:
Spectra of the cobalt 60 calibration source. Stored as I*4.
Archived?:
Yes. pyyddd000_c60.fits
AUX Record Types:

DAT 0 spectral counts

5.1.5 Summary of Cobalt 60 Spectra

File Name Format:
Pyyddd0000_C60SM.SDB
Product Type:
Low-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Contents:
Sums of the cobalt 60 calibration spectra. Stored as R*4.
Archived?:
Yes. pyyddd000_c60sm.fits
AUX Record Types:

DAT 0 spectral counts
CAL_LINE 25 Calibration line information
REL_SPEC 28 Related spectra

5.1.6 Slew Spectra Data

File Name Format:
Pyyddd0000_SEC.SDB
Product Type:
Low-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Contents:
Spectral records accumulated during detector slews between sources. Spectra are stored as I*4.
Archived?:
Yes. pyyddd000_sec.fits
AUX Record Types:

DAT 0 spectral counts

5.1.7 SLOT?

File Name Format:
Pyyddd0000_SLOT.SDB
Product Type:
Low-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Contents:
Archived?:
Yes. pyyddd000_slot.fits
AUX Record Types:

DAT 0 spectral counts

5.2 High-Level Spectral Database Files

5.2.1 Daily Difference Spectra

File Name Format:
Pyydddhhmm_xxx[A|B]#.SDB where xxx specifies the table (PRI/SEC/SOL/TRN) and # is a number used to prevent file name collisions.
Product Type:
High-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Each DDS file generated by BLD_QUAD_DIF contains the background subtracted Daily Difference Spectra for one OSSE target for a single day of observation are stored as R*4.
Contents:
Daily difference - One SDR exists for each 2-minute analyzable unit.
Archived?:
Yes. pyydddhhmm_xxx[a|b]#.fits
AUX Record Types:

AUDEF 34 Analyzable Unit Definition (1st SDR only)
DAT 0 background-subtracted spectral counts
ERR 1 errors for background-subtracted spectral counts
AUID 35 Analyzable Unit IDentifier record

5.2.2 Bottom-Line Spectral File

File Name Format:
*_BLN.SDB
Product Type:
High-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Generated by BOTTOMLINE.
Contents:
A single SDR exists for each view period. Basically a sum of all Spectral Data Records(SDR), for all days and all detectors. Rebinned and includes a detector response matrix.
Archived?:
Yes. *_bln.fits

AUX Record Types:

DAT 0 background-subtracted spectral counts
ERR 1 errors for background-subtracted spectral counts
EDG 5 low edges of energy channels (MeV)
WID 9 widths of energy channels (MeV)
NOTE 30 Information from SDR_SUM and SDR_PUT_MTRX.
CRC 37 Compound Response Coefficients, created by DAY_SUMMER.
COV 45  
RMTRX 38 NCHAN x NPHOT (The order of these dimensions
    should be capatible with XSPEC?)
RMDEF 43  
RMVEC 44 contains 4 vectors of size = Max(NCHAN,NPHOT)

5.2.3 Good-Summed Count Spectra

File Name Format:
*_GSM.SDB
Product Type:
High-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Generated by DAY_SUMMMER.
Contents:
Statistical correlations caused by shared backgrounds in pointing strategy have been removed, making it a better result than the regular Day-Summed DSM file.
Archived?:
Yes. *_gsm.fits

AUX Record Types:

DAT 0 background-subtracted spectral counts
ERR 1 errors for background-subtracted spectral counts
EDG 5 low edges of energy channels (MeV)
WID 9 widths of energy channels (MeV)
NOTE 30 Information from SDR_SUM and SDR_PUT_MTRX.
CRC 37 Compound Response Coefficients, created by DAY_SUMMER.
COV 45  

5.2.4 Totalled Spectral File (*_TOT.SDB)

File Name Format:
*_TOT.SDB
Product Type:
High-level
File Format:
VAX/VMS, indexed, variable length records
Source:
Total count spectra, with response matrix, generated by FIT_PREP.
Contents:
An SDR exists for each detector, totalled for the viewing period. A full spectral resolution response matrix is generated for each detector.
Archived?:
yes. *_tot.fits.

AUX Record Types:

DAT 0 background-subtracted spectral counts( 448 channels)
ERR 1 errors for background-subtracted spectral counts
EDG 5 low edges of energy channels (MeV)
WID 9 widths of energy channels (MeV)
RELSPEC 28  
NOTE 30 Information from SDR_SUM and SDR_PUT_MTRX.
CRC 37 Compound Response Coefficients, created by DAY_SUMMER.
RMTRX 38 Response matrix, created by FIT_PREP (NCHAN x NPHOT)
    (Nominally  448 x 470)
RMDEF 43  
RMVEC 44 Contains 4 vectors of the size Max(NCHAN,NPHOT)
COV 45 Nominally contains 1 SDB per detector per pointing offset(DSA)

5.2.5 AUX-type Summary

This table maps AUX Record Types for the SDB files delivered to the COSSC.

AUX TYPES BY SDB FILE            
SPM BURST SLOT SEC C60 C60SM DDS TOT BLN GSM
0 0 0 0 0 0 0 0 0 0
- - - - - - 1 1 1 1
- - - - - - - 5 5 5
- - - - - - - 9 9 9
- 19 - - - - - - - -
25 - - - - 25 - - - -
- - - - - 28 - - - -
29 - - - - - - - - -
- - - - - - - 28 - -
- - - - - - - 30 30 30
- - - - - - 34 - - -
- - - - - - 35 - - -
- - - - - - - 37 37 37
- - - - - - - 38 38 -
- 42 - - - - - - - -
- - - - - - - 43 43 -
- - - - - - - 44 44 -
- - - - - - - 45 - 45

5.3 Pulsar Data Files (PDF)

File Name Format:
Pyyddd0000.PDF
Product Type:
Low-level
File Format:
Source:
Contents:
Archived?:
No.

5.4 Other File Types (not being archived)

5.4.1 Telemetry Scalar File

File Name Format:
Pyyddd0000.TSF
Product Type:
Low-level
File Format:
Source:
Contents:
Count spectra at maximum time resolution with some summing of energy channels. Not stored in SDB format. Includes the shield rates at high time resolution.
Archived?:
No.

Even more files not yet documented:

Pyyddd0000.TLM:
Raw telemetry data
Pyyddd0000.DQ:
Data quality flags. Not stored in a human-readable form.
Pyyddd0000_DAILY.CPE:
Charged particle event rate integrated over an orbit. Not stored in a human-readable form.
Pyyddd0000.EVNT:
Event lists
Pyyddd0000.HVGL:
High-voltage glitches.
Pyyddd0000.EVNTC6:
Cobalt 60 event lists
Pyyddd0000_MSCRN.DAT:
Generated by the manual screening operations.
Pyyddd0000_COS.DAT:
PLANNING_CATALOG.DAT:
Target list
PERMANENT.DQ
Listing of maneuver start & stop times.
CMDSTATE_TABLE.DAT

Instrument Command Files

These files (OMP*.CMD) contain scripts that call the instrument command files (*.IDL) files listed below.

Next: 6. High-Level OSSE Spectral Up: OSSE Pipeline Documentation Previous: 4. Things Your Mother