Setting the environment

Before you run any OSA software, you must also set your environment correctly.

The commands below apply to the csh family of shells (i.e csh and tcsh) and should be adapted for other families of shells.

In all cases, you have to set the REP_BASE_PROD variable to the location where you perform your analysis (e.g the directory jmx_data_rep). Thus, type:

setenv REP_BASE_PROD $PWD

Then, if not already set by default by your system administrator, you should set some environment variables and type:

setenv ISDC_ENV directory_of_OSA_sw_installation
setenv ISDC_REF_CAT $REP_BASE_PROD/cat/hec/gnrl_refr_cat_0041.fits
source $ISDC_ENV/bin/isdc_init_env.csh

or

export ISDC_ENV=directory_of_OSA_sw_installation
export ISDC_REF_CAT=$REP_BASE_PROD/cat/hec/gnrl_refr_cat_0041.fits
source $ISDC_ENV/bin/isdc_init_env.sh

The user should take care of using an appropriate catalog. The latest one is available at the https://www.isdc.unige.ch/integral/science/catalogueISDC reference catalog page.

The idea is to:

• set ISDC_ENV to the location where OSA is installed
• set ISDC_REF_CAT to the DOL of the ISDC Reference Catalog
• run the OSA set-up script (isdc_init_env.csh) which initializes further environment variables relative to ISDC_ENV.

Besides these mandatory settings, there are two optional environment variables (COMMONLOGFILE and COMMONSCRIPT) which are useful.

• By default, the software logs messages to the screen (STDOUT). To have also these messages in a file (i.e common_log.txt) and make the output chattier, use the command:

  setenv COMMONLOGFILE +common_log.txt
  

• When you launch the analysis, the Graphical User Interface (GUI) is launched. As your level of expertise with the software increases, you may wish to not have the GUIs pop up when you launch your analysis. In this case, the variable COMMONSCRIPT must be defined:

  setenv COMMONSCRIPT 1
  

  When the GUI is disabled, parameters can be specified on the command line typing 'name = value' after the script name.

  To revert and have the GUI again, unset the variable:

  unsetenv COMMONSCRIPT