Launching the analysis in a docker container

OSA is also distributed as a docker container, suitable for any distribution where docker is supported (e.g. Linux, Mac OS X, or even Windows).

A detailed description for using OSA inside docker is given in the https://www.isdc.unige.ch/integral/download/osa/doc/11.0/osa_inst_guide.pdfOSA iinstallation guide Here, we underline that a convenience script is distributed to invoke the analysis.

First, you need to have docker installed on your machine, then, you need to pull the image

docker pull integralsw/osa

for the latest version or

docker pull integralsw/osa:11.0

for the specific OSA 11.0 tag.

Then, you need to download the instrument characteristics and the data you need to analyze in some arbitrary location, but different from the directory used for the analysis, see below. Suppose you have downloaded the Instrument characteristics with the command:

rsync -Lzrtv isdcarc.unige.ch::arc/FTP/arc_distr/ic_tree/prod/ \
/home/integral/ic_tree

into /home/integral/ic_tree.

Suppose that you downloaded data from revolution 102 with the commands

rsync -lrtv isdcarc.unige.ch::arc/FTP/arc_distr/CONS/public/scw/0102/ \
/home/integral/archive/scw/1667
rsync -lrtv isdcarc.unige.ch::arc/FTP/arc_distr/CONS/public/aux/adp/ref \
/home/integral/archive/aux/adp
rsync -lrtv isdcarc.unige.ch::arc/FTP/arc_distr/CONS/public/aux/adp/0102.001 \
/home/integral/archive/aux/adp

after creating the necessary directories. So that your archive will be /home/integral/archive.

Finally, you need to change directory into a writable directory, where the script will store your analysis results and parameter files, let's assume you do
cd /home/integral/results

You can define now a list of science windows to analyze:

cat > jmx.lst <<EOF
010200210010.001
010200220010.001
EOF

With an active network connection, the following command will allow you to create an observation group

REP_BASE_PROD=/home/integral/archive \
CURRENT_IC=/home/integral/ic_tree \
bash <(curl https://gitlab.astro.unige.ch/savchenk/osa-docker/raw/master/osa-docker.sh) \
og_create idxSwg=scw.lis ogid=crab baseDir=./ instrument=JMX1

Notice that the variables REP_BASE_PROD indicates the location of your data, and CURRENT_IC the IC location (backward symbolic links are strictly forbidden in both cases).

To run the IBIS science analysis, you can now

cd obs/my_og
REP_BASE_PROD=/home/integral/archive \
CURRENT_IC=/home/integral/ic_tree \
bash <(curl https://gitlab.astro.unige.ch/savchenk/osa-docker/raw/master/osa-docker.sh) \
jemx_science_analyis

a graphical window will open and you can run the analysis as explained below. Notice that you can use any of the commands described below in a docker container just prepending the command (this is in bash!) REP_BASE_PROD=/home/integral/archive CURRENT_IC=/home/integral/ic_tree bash <(curl https://gitlab.astro.unige.ch/savchenk/osa-docker/raw/master/osa-docker.sh)