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 reference orbit test (R.O.T.) data
For more information please read the individual help files of the programs used (e.g. spi_science_analysis --help).
step purpose What you have to do
setup   have your own data_rep on your account. Follow the R.O.T. setup advice.
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 prepare a list of SCWs create a list of SCWs. Here is one example for a valid list of one SCW: dols.txt. Or use this rotdols4.txt to create an index including 4 SCWs. Please have a look on the list of usable R.O.T. data. Please note that the source was outside the field of view so that SPIROS and SPISKYMAX are somehow not reproducing the correct image.
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.
cp $ISDC_ENV/help/source_cat_in.fits . copy source catalogue Analysis is faster if you give to SPIROS and SPISKYMAX an input catalogue. This catalogue is using the source position as seen by SPI during the ROT.
(if you want to avoid the GUI, unsetenv DISPLAY before starting spi_science_analysis !)
do the analysis start with spi_science_analysis, 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_rot.par (if you want to use it, copy it to $PFILES/spi_science_analysis.par; more paramter file examples can be found on this page). For different sets of detectors you need different response (IRF). You can get a detector list if you are not familiar with our pseudo-detector scheme. Which IRFs do you want to use? Begin with small numbers of energy bins! Read also the SPIROS documentation.
fv spi/source_res.fits
output check read the log file, check the images, events table and so on. If it is failing - check for missing/wrong input parameters first.
spi_science_analysis step back and repeat parts of the analysis Run spi_science_analysis again in the level range you like. E.g. start from binning again up to the imaging/spectra level by using StartLevel = BIN_I and EndLevel = IMA.

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