PDS_VERSION_ID     = PDS3
RECORD_TYPE        = FIXED_LENGTH
RELEASE_ID         = 0001
REVISION_ID        = 0000

OBJECT             = TEXT
  PUBLICATION_DATE = 2003-12-04
  NOTE             = "Description of XSM delivered software included in
    the SOFTWARE directory"
END_OBJECT
END

SOFTWARE directory of XSM PDS archive
=======================================
 
SOFTWARE directory contains XSM software necessary to produce input
data for XSPEC spectral fitting applications.

This software is delivered as a compressed file.

The SOFTWARE directory contains the following files:

File Name           File Contents
----------------    --------------------------------------------------------
SOFTINFO.TXT        Description of the contents of this directory. This file.
XSM_SOFT.ZIP        Compressed file containing the DG.PRO and RA.PRO 
                    applications and MU_SI.FITS auxiliary data table
                    required to produce input data for XSPEC.
XSM_SOFT.LBL        Detached PDS label describing the XSM_SOFT.ZIP file.



DESCRIPTION OF THE S/W PROGRAMS NEEDED TO ANALYZE XSM SPECTRAL DATA
===================================================================

List of all S/W programs(=ASCII files in this directory) needed to 
reduce the 1 b level data up to level 3b data.

(NOTE: Run IDL by entering ".r RA.PRO" or ".r DG.PRO"!)

LIST OF S/W PROGRAMS:

1. DG.PRO
2. RA.PRO

1.DG.PRO  (IDL) 

This program generates FITS-formetted XSPEC applicable spectral data
files.
Input: Delivered data table of level 1 b e.g. CCYY-MM-DDThh:mm:ss_1.DAT 
Output: XSM_NNNN.DAT, N's are ascending numbers from 0 to 9999 e.g row numbers
in the DATA TABLE CCYY-MM-DDThh:mm:ss_1.DAT

2.RA.PRO  (IDL) 

This program generates FITS-formetted XSPEC applicable Ancillary Response
files (ARF) and FITS-formetted XSPEC applicable Redistribution Matrix Files
(RMF).
Input: Delivered data table of level 1 b e.g. CCYY-MM-DDThh:mm:ss_1.DAT 
Output: XSM_NNNN.ARF, N's are ascending numbers from 0 to 9999 e.g row numbers
in the DATA TABLE CCYY-MM-DDThh:mm:ss_1.DAT.
As a default this program generates just one RMF (=YYYY_MM_DDThh_mm.RMF),
which has gain and offset are calculaetd as mean values of start and end calibrations.
A log file is also generated automatically. Take a closer look at this log file after
running RA.PRO! You can generate a specific RMF for each spectrum by adjusting the NX 
value to correspond to the row number, i.e. spectrum in the data file. This is recommendated
when the gain shift between the start and end of the observation is greater that 20 eV.  
   

AUXILIARY DATA TABLE:

1. MU_SI.FITS

This file includes silicon mass attenuation cofficiects between
0.03 and 20 keV. It is needed to compute the Response Matrix File.
It is input table of the program RA.PRO.