Integral

Quick Look Analysis

http://isdc.unige.ch/heavens/

How does the INTEGRAL analysis software work in general? http://www.isdc.unige.ch/integral/download/osa/doc/10.0/osa_um_ibis/node27.html

INTEGRAL Scripts

Can be found under

/data/system/software/scripts/intscripts/

on remeis machines. If you want/need an introduction, talk to Tobi. Also, someone may want to write a few examples. At some points. [VG: not me]

How to create mosaics

First make a list of scws you want to add to a mosaic, i.e., a "dol-file" dol.txt:

 /scratch1/beuchert/integral/scw_extr/obs/066200340010/scw/066200340010.001/swg_ibis.fits
 /scratch1/beuchert/integral/scw_extr/obs/066200350010/scw/066200350010.001/swg_ibis.fits
 /scratch1/beuchert/integral/scw_extr/obs/066200360010/scw/066200360010.001/swg_ibis.fits

Then prepare the directory where the mosaic shall be built in, i.e., set the env. variables to allow INT_mosa_ibis to find indices etc.:

 cd /some/path/
 ln -s /virgo/b/INTEGRAL/aux/
 ln -s /virgo/b/INTEGRAL/idx/
 ln -s /virgo/b/INTEGRAL/ic/
 ln -s /virgo/b/INTEGRAL/scw/
 ln -s /virgo/b/INTEGRAL/cat/
 mkdir /some/path/obs/
 
 INT_mosa_ibis --obsgrp=/path/to/all/extracted/scws/ --destin=/path/to/the/prepared/directory/obs/mosa_og/ --dol="dol.txt"

abbreviations

http://www.isdc.unige.ch/integral/support/glossary

DAL The Data Access Layer (DAL) is a software library used to manipulate (create, write, read and manage) scientific data.
DOL The Data Object Location (DOL) specifies the location of a DAL object, both by the FITS file name and its extension. For instance, /isdc/dev/xxx.fits[2] is a DOL, while xxx.fits is simply the name of a FITS file.

Known Issues

In general: check first http://www.isdc.unige.ch/integral/support/faq for the error code you get

Mosaicing using custom DOLs

If you want to create a mosaic using DOL (Data Object Location) files, sometimes the building interrupts with errors like a Fortran Runtime error (http://www.isdc.unige.ch/integral/support/faq.cgi?SOFT-051) or errors like:

 Using and copying first SCW >>/scratch1/beuchert/integral/scw_extr/obs/125400400010/scw/125400400010.001/swg_ibis.fits
 <<
 Log_0  :  100 elements opened.
 Log_0  :  100 elements attached.
 Error_1: Can not update the index.

or

 Error_1: Can not close the element

or

 Error_2: DAL_READ_ERROR : error reading from FITS file

etc.

Solutions:

Somehow corrupted scws? Collect sets of two scws and create Mosaics based on those. Like that it is easy to enclose corrupted scws.
An error -2004 (DAL_FILE_NOT_ACCESSIBLE) often results because one of your groups is corrupted. Before restarting the analysis, make a ``dal_clean, which should be able to do an automatic repair. If it does not work try a ``dal_verify to see what is corrupted. Or you can try to open your group (or child group) with fv and look for a file pointed by the group that does not exists. Most of the time removing the line with this wrong file in the group table is fixing your problem.

The latter: first create an observation group out of your dol-list of scws. Creating observation groups is also the canonical way of extracting INTEGRAL/IBIS data. Before doing that, the soft links as noted above have to be set in the directory. Then:

 cd path/to/dir/with/softlinks/
 og_create idxSwg=dol.txt ogid=isgri_gc baseDir="./" instrument=IBIS
 ls obs/isgri_gc/

Repair the observation group and included indices/links with

 dal_clean inDOL="obs/isgri_gc/og_ibis.fits" chatty="4" checkExt="1"

Now INT_mosa_ibis should work again on the scws in dol.txt