skip to content
INTEGRAL U.S. Guest Observer Facility
SPI: News! User Manuals Data IRFs and RMFs Documents & Links ISDC SPI page FAQs Contact
User manual for analysing SPI data
For more information please read the individual help files of the programs used (e.g. spi_science_analysis --help). For a detailed step-by-step guideline have a look on the SPI cookbook
step purpose What you have to do
setup   have your own data_rep on your account. Follow the setup advice for GSFC or the setup advice for ISDC.
setenv COMMONLOGFILE mylog.txt define a logfile If you want to have a log file, set it now. To unset it later just type "unsetenv COMMONLOGFILE"
emacs dols.txt create a list of SCWs Here is one example for a list of one SCW: dols.txt and a list for the Cygnus hexagonal observation: dols_cyg.txt. Please have a look on the list of usable data.
og_create idxSwg="dols.txt" ogid="obs_id" baseDir="." create the OG give a (up to now not existing!) name for the obs-branch (obs_id).
cd obs/obs_id   go to your obs branch.
blc_spipoint only for
revolution 1 - 10
For data before revolution 11 spipoint is not working - therefore apply blc_spipoint first. spipoint is also not working for revolution 11 science window 00112901xxx! Note: blc_spipoint sometimes crashes when using more than one science window at a time.
(if you want to avoid the GUI, unsetenv DISPLAY before starting spi_science_analysis !)
do the analysis start with spi_science_analysis (with level GTI, after applying blc_spipoint for revolution 1 - 10, with level POIN for revolution 11 onward), fill in the parameters for the analysis (either off-line using an editor, or by using the GUI which will appear on the screen). The following parameter file can be a basis for your analysis: spi_science_analysis.par (if you want to use it, copy it to your $PFILES/spi_science_analysis.par). You can get a detector list if you are not familiar with our pseudo-detector scheme. Which IRFs do you want to use (leave empty for automatic access)? Begin with small numbers of energy bins!
Read also the user manuals of spiros.
fv spi/source_res.fits
output check use spi_dsp_display to plot the detector spectra and spi_spectral_display for the spiros output spectra. Read also the log file, check the images, events table and so on. If your analysis is failing - check for missing/wrong input parameters first and check the frequently asked question page.
You can fit the SPIROS spectra using XSPEC: How to use XSPEC on SPIROS output spectra
spi_science_analysis step back and repeat parts of the analysis Run spi_science_analysis if you want to do only the IMA level again or run SPIROS manually. If you want to start from binning again, use spi_science_analysis.

In case of questions and comments: contact me at GSFC.