spi psd tlib User Manual
Contents
1. ct copy of the PSD onboard template fitting algorithm The fitting result consists of e PSD_FIT_TTP1 The library template time to peak value of the smaller of the two fitted templates e PSD_FIT_TTP2 The library template time to peak value of the larger of the two fitted templates e PSD_FIT_AMP The relative amplitude of the smaller library template with respect to the larger tem plate By definition PSD_FIT_AMP lt 0 5 e PSD_FIT_CHISQR The Chi squared of the fitting result These fitting result are automatically inserted in the corresponding columns in the curve OSM data structures Previous fitting results that may already be present in these columns will be replaced The spi psdfitlib fitting algorithm is identical to the PSD onboard algorithm hence the results may be compared to the onboard fitting results The only difference between onboard and onground fitting is the length of the pulse shape which consists of 90 time steps onboard from which the first 79 are only transmitted to ground However a reasonable PSD pulse shape should be much shorter typically 30 40 time steps and the fitting result should not be much affected by this difference The executable spi_psd_fitlib is written in the ANSI C language It has been developped under ISDC support platform 4 1 and requires spi_psdlib 1 6 0 and spi_toolslib 1 8 0 or higher 2 Getting started Before installing spi_psd_fitlib make sure that the ISDC support platform 4 12. obber specifies if existing data structures should be overwritten 4 Interface definition spipsd_fitlib works either on indivdual science windows or on observation group On output the columns PSD_FIT_TTP1 PSD_FIT_TTP2 PSD_FIT_AMP and PSD_FIT_CHISQR of the PRP data structure are updated with the fitting results Any previously existing result is overwritten 5 Error codes The following error codes are defined SPI_PSD_FITLIB_ERROR_MEM_ALLOC 230600 They have the following meaning e SPI_PSD_FITLIB_ERROR_MEM_ALLOC an error occured during dynamical memory allocation Probably your system resources are not sufficient to run spi_psd_fitlib
3. or higher is installed on your system and that you have installed the libraries spi_psdlib 1 6 0 and spi_toolslib 1 8 0 or higher After downloading the spi_psd_fitlib tar gz file step into a directory that should hold the distribution move the spi_psd_fitlib tar gz file into this directory and type gunzip spi_psd_fitlib tar gz tar xvf spi_psd_fitlib 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 spi_psd_fitlib User Manual 2 Finally build the distribution by typing make global_install To perform a unit test type make test Make sure that the test data spi_test_data 1 0 tar gz are available at your site they should reside in a directory whose name is defined by the ISDC_TEST_DATA_DIR environment variable spi_psd_fitlib User Manual 3 Parameter file EHEHEHEH HERE HEAR ERA EIRE RHR HERBE RHEE HRA RHEE RER REA REA RER AE RARER RE Centre d Etude Spatiale des Rayonnements in collaboration with ISDC SPI PSD ANALYSIS BR 777 File spi_psd_fitlib par Version 1 1 0 Component PA Author Juergen Knoedlseder knodlseder cesr fr CESR Purpo
4. pardol specifies the DOL of the PSD algorithm parameters that should be used for pulse fitting e set specifies the template set from that should be used for the pulse fitting e onground specifies if the PSD pulses should be filtered onground using the criteria defined in the algorithm parameters e fitalltpls specifies if all templates from the library should be used for fitting or if only the number of templates specified in the PSD algorithm parameter block should be used default is yes e adcO_gain specifies the gain correction that should be applied for the PSD ADC convertor 0 As default select 1 0 e adci gain specifies the gain correction that should be applied for the PSD ADC convertor 1 As default select 1 0 e adc2 gain specifies the gain correction that should be applied for the PSD ADC convertor 2 As default select 1 0 e adc3 gain specifies the gain correction that should be applied for the PSD ADC convertor 3 As default select 1 0 e adc0 offset specifies the offset correction that should be applied for the PSD ADC convertor 0 As default select 0 0 e adci offset specifies the offset correction that should be applied for the PSD ADC convertor 1 As default select 0 0 e adc2 offset specifies the offset correction that should be applied for the PSD ADC convertor 2 As default select 0 0 e adc3 offset specifies the offset correction that should be applied for the PSD ADC convertor 3 As default select 0 0 e cl
5. se Parameter file of the SPI PSD library fitting executable History 1 1 0 21 Aug 2002 First ISDC delivery Rev 1 SIE SE SEE ESS ELLE ES EGE ELEG UL REAR a RAE AREA RRR RRA RRR RAR The input DOLs curveDOL s ql og_spi fits 1 Input DOL SWG IDX 0G 1ibDOL s ql psd fits SPI LIB PSD PSD template library DOL algoparDOL s ql psd fits SPI ALGO PSD PSD algorithm parameters DOL Task parameters p set i ql 0 0 1 Template library set 0 1 onground b ql yes On ground pulse filtering fitalltpls b ql yes Use all available templates for fitting adc0 gain r h 1 0 Gain PSD ADC 0 adci_gain r h 1 0 Gain PSD ADC 1 adc2 gain r h 1 0 Gain PSD ADC 2 adc3_gain r h 1 0 Gain PSD ADC 3 adcO_offset r h 0 0 Offset PSD ADC 0 adci_offset r h 0 0 Offset PSD ADC 1 adc2_offset r h 0 0 Offset PSD ADC 2 0 0 adc3_offset r h gt gt Offset PSD ADC 3 Standard parameters H clobber b h no Overwrite existing data structures The following parameters have to be specified e curveDOL specifies the input group that holds the PSD curves that should be fitted The input group spi_psd_fitlib User Manual 4 may be either a single science window or an observation group e libdol specifies the DOL of the template library that should be used for pulse fitting e algo
6. spi_psd_fitlib User Manual Version 1 1 0 21 August 2002 Jurgen Knodlseder Centre d Etude Spatiale des Rayonnements knodlseder cesr fr http www cesr fr jurgen index html spi_psd_fitlib 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 ii spi_psd_fitlib User Manual Contents 1 Introduction 2 Getting started 3 Parameter file 4 Interface definition 5 Error codes il spi_psd_fitlib User Manual 1 1 Introduction The executable spi_psd_fitlib performs library fitting of PSD curve data This task is complementary to the executable dp_spi_psd which performs routinely pulse fitting of PSD curves on science window basis spi_psd_fitlib is aimed to allow for independent pulse fitting in particular in view of a deeper investigation of PSD pulse fitting performances One may use spi_psd_fitlib to compare library fitting results for different PSD template libraries or different PSD algorithm parameters For each curve in the input data structure spi_psd_fitlib determines the best fitting pair of library templates by means of a least Chi squared fitting technique the algorithm is an exa
Download Pdf Manuals
Related Search