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.
spi_science_analysis (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.