PDS_VERSION_ID     = PDS3                                                     
RECORD_TYPE        = STREAM                                             
RELEASE_ID         = 0001                                                     
REVISION_ID        = 0001                                                     
                                                                              
OBJECT             = TEXT                                                     
  PUBLICATION_DATE = 2009-10-06                                               
  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 CODMAC 2 level data up to level 4 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 CODMAC level 2, e.g. XSM_NE_R00300_00.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 CODMAC level, e.g. XSM_NE_R00300_00.DAT        
Output: XSM_NNNN.ARF, N's are ascending numbers from 0 to 9999 e.g row numbers
in the XSM_NE_R00300_00.DAT.                                                  
As a default this program generates just one RMF (=XSM_NE_R00300_00.RMF),     
which has gain and offset are calculaetd as mean values of start and end      
calibrations.                                                                 
                                                                              
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.