spi tm2 ts User Manual
Contents
1. in collaboration with ISDC SPI Pre Processing 2222222222222 File spi_tm2fits par Version 1 5 0 Component pp Author Juergen Knoedlseder knodlseder cesr fr CESR Purpose Parameter file of the SPI pre processing executable History 1 5 0 18 Jul 2002 HR EEE EEE EEE EIRE EIRE EEE EEE Path name definition H tmpath s h x02 tm TM Base Path scwbase s h villa 1 jurgen arc tst_tm scw Science Window Base Path cfgbase s h users jurgen isdc templates Template Base Path TM input definition 2 2 2 2 2 2 2 2 2 2 2 2 2 2 nfirst i ql 515 First TM file number nlast i ql 515 Last TM file number pktmin i ql 400174 1 10000000 First packet to scan in first TM file pktmax i ql 447092 1 10000000 Last packet to scan in last TM file header i h 0 Header size in Bytes Science window definition 2 2 2 2 2 2 2 2 2 2 2 2 2 2 2222 222 revid s ql 9000 Revolution ID pointid s ql 0080 Pointing ID minimum is 0000 subid s ql 001 Subdivision ID minimum is 001 scutype s ql 2 0 112 Science Window Type Ozpointing 1 slew 2 other version s ql 001 Version number previd s ql 000000000000 Previous Science Window ID Task parameters 4 method s ql PROCESS SCAN PROCES2. DMPH RAW DPPS RAW spi raw spi raw oper fits spi raw spi raw emer fits spi raw spi raw calb fits spi raw spi raw diag fits Content Single events OPER PSD events OPER PSD curves OPER Double events OPER Tripple events OPER Quadruple events OPER Quintuple events OPER Multiple events OPER Tripple with PSD events OPER Quadruple with PSD events OPER Quintuple with PSD events OPER Setuple with PSD events OPER Multiple with PSD events OPER Pure PSD events OPER Double events EMER Tripple events EMER Quadruple events EMER Quintuple events EMER Multiple events EMER Tripple with PSD events EMER Quadruple with PSD events EMER Quintuple with PSD events EMER Setuple with PSD events EMER Multiple with PSD events EMER Pure PSD events EMER PSD curves CALB Single events DIAG PSD events DIAG PSD curves DIAG Double events DIAG Tripple events DIAG Quadruple events DIAG Quintuple events DIAG Multiple events DIAG Tripple with PSD events DIAG Quadruple with PSD events DIAG Quintuple with PSD events DIAG Setuple with PSD events DIAG Multiple with PSD events DIAG Pure PSD events DIAG Additional data structure may be craeted by spi_tm2fits yet they will not be filled with information spi_tm2fits User Manual The following header keywords of the science window group are set by spi_tm2fits Keyword Value Content INSTRUME SPI INTEG
3. RAL Instrument ERTFIRST Earth received time start of telemetry ERTLAST Earth received time stop of telemetry SWBOUND Reason for Science Window ending PCKSTART First TM packet PCKEND Last TM packet In addition the following keywords are added to the RAW data structure headers Keyword Value Content ERTFIRST Earth received time start of telemetry ERTLAST Earth received time stop of telemetry PCKSTART First TM packet PCKEND Last TM packet SSC_BEG First SSC in data SSC_END Last SSC in data SSC_GAP Number of SSC gaps in data All photon data structures will also have the additional keywords Keyword Value Content LOBT_SBK Local OBT start of block LOBT_EBK Local OBT end of block BLCK_NUM Number of 125 ms patterns in data BLCK_GAP Number of 125 ms pattern gaps in data 5 Error codes The following error codes may be returned by spi_tm2fits SPI_TM2FITS_ERROR_BASE 10000 Error base SPI_TM2FITS_ERROR_MEM_ALLOC 10000 Memory allocation error SPI_TM2FITS_ERROR_EOF 10001 End of file reached SPI_TM2FITS_ERROR_FILE_ERROR 10002 TM file error SPI_TM2FITS_ERROR_INVALID_BUFFER 10003 Invalid buffer
4. S Working method SCAN PROCESS bcpid s ql 00000000 Broadcast packet ID subound s ql UNDEFINED Reason for Science Window ending spi_tm2fits User Manual 3 ISDC Standard Parameters clobber b h no Clobber Flag mode s h ql Execution mode The parameters have the following meanings tmpath specified the directory which holds the PktA11 telemetry files in the CESR GSE format in this format telemetry frames are stored as successive blocks of 440 Bytes in a single binary file scwbase specifies the Science window base path into which the science window data structures should be written cfgbase specifies the absolute directory in which the science window group configuration files will be found Normally the directory where the data structure templates are found should be specified nfirst specifies the file number of the first PktA11 telemetry file that should be processed nlast specifies the file number of the last PktA11 telemetry file that should be processed pktmin specifies the first packet in the first telemetry binary file specified by the parameter nfirst that should be processed the first packet has the packet number 1 A packet is defined as a 440 Bytes block in the telemetry binary file If pktmin 1 pre processing starts from the beginning of the telemetry file pktmax specifies the last packet in the last telemetry binary file specified by the parameter nlast tha
5. cs calib fits eng raw spi raw dump fits eng raw spi raw cnes fits eng raw spi raw block fits eng raw spi raw schk fits HDU SPI SPI ACS CRW DFMD HRW SPI ASMD HRW SPI PDMD HRW CNES PDU HRW CNES RTU HRW SPI OBLK HRW SPI EBLK HRW SPI CBLK HRW SPI DBLK HRW SPI SHK1 TMP SPI SHK2 TMP SPI SHK3 TMP SPI SHK4 TMP SPI SHKS TMP Content ACS calibration data DFEE memory dumps non ISDC ACS memory dump non ISDC PSD memory dump non ISDC CNES PDU data non ISDC CNES RTU data non ISDC Photon data block structure Photon data block structure Photon data block structure Photon data block structure Science HK temporary 1 Science HK temporary 2 Science HK temporary 3 OPER EMER CALB DIAG NN Science HK temporary 4 Science HK temporary 5 spi_tm2fits User Manual The following HDUs are filled by spi_tm2fits in the private spi branch of the science window structure HDU Filename OSGL RAW OPSD RAW OCRV RAW OME2 RAW OME3 RAW OME4 RAW OMES RAW OMEH RAW OMP3 RAW OMP4 RAW OMP5 RAW OMP6 RAW OMPH RAW OPPS RAW EME2 RAW EME3 RAW EME4 RAW EME5 RAW EMEH RAW EMP3 RAW EMP4 RAW EMP5 RAW EMP6 RAW EMPH RAW EPPS RAW CCRV RAW DSGL RAW DPSD RAW DCRV RAW DME2 RAW DME3 RAW DME4 RAW DME5 RAW DMEH RAW DMP3 RAW DMP4 RAW DMP5 RAW DMP6 RAW
6. ethod If SCAN is specified the telemetry file is only scanned and statistics about the contained data types will be dumped into the RIL log file No RAW data will be written If PROCESS is specified the telemetry file will first be scanned to determine the DAL table size of the resulting RAW data structures and in a second pass the telemetry will be pre processed and written into the data structures spi_tm2fits User Manual 4 e bcpid specifies the Broadcast packet identifier for the telemetry to be stored in the headers of the RAW data structures e swbound specifies the reason for science window ending Possible reasons are SLEW POINTING TIMEOUT and UNDEFINED e clobber ISDC standard parameter see Common User Manual e mode ISDC standard parameter see Common User Manual spi_tm2fits User Manual 5 4 Interface definition spi_tm2fits creates a science window group of ISDC level RAW from the input telemetry files that is compliant with the ISDC data structure defintions The following HDUs are filled by the executable in the public eng branch of the science window structure Filename HDU Content eng raw intl stsp fits INTL STSP SRW Spacecraft time packet eng raw intl_rawhk fits INTL PLM HRW Spacecraft PLM packet INTL CDMU HRW Spacecraft CDMU packet INTL AOCS HRW Spacecraft AOCS packet INTL SVM1 HRW Service module 1 packets only SPI parameters INTL SVM2 HRW Service module 1 packets only SPI parameters eng ra
7. plates that are supplemented concern data that is normally not analysed by the ISDC system such as CNES GSE packets or sub assembly memory dumps spi_tm2fits has been written in the ANSI C language and requires the libraries spi psdlib and spi toolslib The actual version is compliant with the ISDC support platform 4 1 2 Getting started Before installing spi_tm2fits make sure that the ISDC support platform 4 1 or higher is installed on your system and that the libraries spi psdlib and spi_toolslib are also available please consult the WWW site http www cesr fr jurgen isdc if these libraries are not available on your system After downloading the spi_tm2fits tar gz file step into a directory that should hold the distribution move the spi_tm2fits tar gz file into this directory and type gunzip spi_tm2fits tar gz tar xvf spi_tm2fits tar The first command uncompresses the distribution file the second unpacks the files Before configuration the distribution needs to be reset to a clean state To do this type make distclean Then configure the distribution It is assumed here that you have previously installed the ISDC support platform thus you should type bin ac_stuff configure Finally build the distribution by typing make global_install spi_tm2fits User Manual 3 Parameter file HR ERA REA RAMA RMA RHR HEAR RHEE RHR RAMA AMA RMA AMMA RAMA RAMA RAMA Centre d Etude Spatiale des Rayonnements
8. spi tm2fits User Manual Version 1 5 1 30 July 2002 Jurgen Knodlseder Centre d Etude Spatiale des Rayonnements knodlseder cesr fr http www cesr fr jurgen index html spi_tm2fits User Manual Note to the user This software has been written to analyse data of the SPI telescope onboard INTEGRAL Particular care has been taken in making the software user friendly and well documented If you appreciated this effort and if this software and User Manual were useful for your scientific work the author would appreciate a corresponding acknowledgment in your published work il spi_tm2fits User Manual Contents 1 Introduction 2 Getting started 3 Parameter file 4 Interface definition 5 Error codes il spi_tm2fits User Manual 1 1 Introduction The executable spi_tm2fits converts INTEGRAL or SPI telemetry in the format of the CESR GSE aqui sition system PktAll into a ISDC compliant data structure of ISDC level RAW Each run of spi tm2fits produces a single science windows hence to cut a data stream into science window it has to be applied suc cessively to the input data with different input packet limitations use the task spi_tmscan to automatically devide a data stream into science windows spi_tm2fits comes with a number of data structure templates that may either replace or supplement existing ISDC templates Templates that are replaced are ISDC templates that do not reflect the actual status of the data base Tem
9. t should be processed packets start from number 1 A packet is defined as a 440 Bytes block in the telemetry binary file If pktmax is larger than the number of available packets the telemetry file is analysed until the end of the file is reached header specifies the number of Bytes in the telemetry binary file header Earlier versions of the PktAll files had a header attached The actual version do not have a header anymore hence as default 0 should be specified revid specifies the revolution identifier of the science window that should be generated This parameter has to be a 4 character string pointid specifies the pointing identifier of the science window that should be specified This param eter has to be a 4 character string The minimum pointing identifier is 0000 subid specifies the subdivision identifier of the science window that should be specified This parameter has to be a 3 character string The minimum subdivision identifier is 001 scutype specifies the science window type The following types are allowed 0 is a pointing 1 is a slew and 2 is any other science window type version specifies the science window version number This parameter has to be a 3 character string previd specifies the previous science window identifier without version number This identifier will be stored in the science window grouping table header and allows for linking of the science windows method specifies the telemetry processing m
10. w spi raw acs fits SPI FEEO HRW ACS group 0 count rates SPI FEE1 HRW ACS group 1 count rates SPI FEE2 HRW ACS group 2 count rates SPI FEE3 HRW ACS group 3 count rates SPI FEE4 HRW ACS group 4 count rates FEES HRW ACS group 5 count rates FEE6 HRW ACS group 6 count rates FEE7 HRW ACS group 7 count rates FEE8 HRW ACS group 8 count rates FEE9 HRW ACS group 9 count rates FEEA HRW ACS group 10 count rates FEEB HRW ACS group 11 count rates OACS HRW ACS overall count rates eng raw spi raw hk fits DPE HRW SPI DPE HK 1 second 001 HRW SPI HK 8 seconds 008 HRW SPI HK 64 seconds 080A HRW SPI HK 640 seconds a 080B HRW SPI HK 640 seconds b 480A HRW SPI HK 3840 seconds a 480B HRW SPI HK 3840 seconds b 480C HRW SPI HK 3840 seconds c 480D HRW SPI HK 3840 seconds d eng raw spi raw dhk fits DHKO CRW DIAG housekeeping packet 0 DHK1i CRW DIAG housekeeping packet 1 DHK2 CRW DIAG housekeeping packet 2 DHK3 CRW DIAG housekeeping packet 3 DHK4 CRW DIAG housekeeping packet 4 DHK5 CRW DIAG housekeeping packet 5 DHK6 CRW DIAG housekeeping packet 6 DHK7 CRW DIAG housekeeping packet 7 DHK8 CRW DIAG housekeeping packet 8 DHK9 CRW DIAG housekeeping packet 9 DHKA CRW DIAG housekeeping packet 10 DHKB CRW DIAG housekeeping packet 11 spi_tm2fits User Manual Filename eng raw spi a
Download Pdf Manuals
Related Search