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 ibis_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:

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

notice that the catalog number should be updated to the latest available version of one of your choice. Here, we indicated the latest catalog available at the time of writing.

Note that it is important to ensure that the version of the catalog is at least `0031' (gnrl_refr_cat_0031.fits) because it includes new flags that are used by OSA.

The latter command executes the OSA set-up script (isdc_init_env.csh) which initialises further environment variables relative to ISDC_ENV. Ignore all possible warnings mentioning ROOTSYS.

Besides these mandatory settings, the optional environment variable COMMONLOGFILE can also be useful. By default, the software logs messages to the screen (STDOUT). To have these messages in a file (i.e common_log.txt), and make the output chattier use the command:

setenv COMMONLOGFILE +common_log.txt