OSIRIS Pipeline

Installation

Installation is not very difficult, but a few remarks may be important for the users.

1. You need astrolib (e.g. http://idlastro.gsfc.nasa.gov/) and(!) the ICG lib (e.g. http://www.fz-juelich.de/icg/icg-i/idl_icglib/idl_lib_intro.html). Many routines written by Craig Markwardt (e.g. http://cow.physics.wisc.edu/~craigm/idl/idl.html) are also needed (if not already part of your installation tarball)

2. You need the cfitsio package.

3. The pipeline can be installed for many users on the same machine by separating the queue-, log-, ... directories.

Step 1: Create in any directory (e.g. /home/me/OSIRIS ) the following directories:

data : here lives your data (alternatively you can omit this directory if you declare OSIRIS_DRP_DATA_PATH in setup_osirisDRPSetupEnv appropriately (see below))
drf_queue : this is your personal queue directory
drf_queue/logs : this is your personal log directory
env : this is your personal env directory
out : where the results go (not really necessary)
RPB : this is where your favorite RPBconfig.xml resides.
SupportFiles : this is where we look for the file that tells the pipeline which RPBconfig.xml to use
XML : this is where your XML files reside (not really necessary)

Step 2: In your .tcshrc (or .cshrc or whatsoever) declare:

setenv OSIRIS_ROOT the_directory_where_the_pipeline_software_resides setenv OSIRIS_USER /home/me/OSIRIS setenv PATH $OSIRIS_ROOT/scripts:$PATH source $OSIRIS_USER/env/setup_osirisDRPSetupEnv

Step 3: copy setup_osirisDRPSetupEnv to the env directory you created and change the environment variables for the shell in this file.
It should look like this one:
--------------------------------------------------------------------------
# Location of data files
setenv OSIRIS_DRP_DATA_PATH $OSIRIS_USER/data/

# Set the queue directory for any pipelines started by this user
setenv DRF_QUEUE_DIR $OSIRIS_USER/drf_queue

# Set a default for the overall (general) DRP log files to go.  These log
# files are created each time the pipeline backbone is started
setenv OSIRIS_DRP_DEFAULTLOGDIR $OSIRIS_USER/drf_queue/logs

# This is where the backbone IDL code looks for the shared libraries that
# implement C code called by the IDL code.
setenv OSIRIS_DRP_EXTERNAL_LIB_DIR $OSIRIS_ROOT/modules/source

# This is where the backbone IDL code looks for the shared libraries that
# implement C code called by the IDL code.
setenv OSIRIS_BACKBONE_DIR $OSIRIS_ROOT/backbone

# Specify where the configuration filename is stored. This file just
# contains the real name of the configuration file.
setenv OSIRIS_DRP_CONFIG_FILE $OSIRIS_USER/SupportFiles/local_osirisDRPConfigFile

setenv OSIRIS_IDL_BASE $OSIRIS_ROOT
setenv OSIRIS_ALTERNATE_DRF_QUEUE_DIR $DRF_QUEUE_DIR
--------------------------------------------------------------------------
Step 4: copy your favorite RPBconfig.xml to the RPB directory you created.

Step 5: create the file local_osirisDRPConfigFile in the SupportFiles directory you created. The file must contain the absolute path to your RPBconfig.xml. In our example : /home/me/OSIRIS/SupportFiles/RPBconfig.xml

Step 6: Since users can use various IDL versions (higher than 6.0) each user should create a pipeline start-up file (e.g. op) where the Shell can find it (in the manual this is run_odrp). This file looks like this one:
#!/bin/csh -f
#start drp
xterm +ls -e the_command_to_start_your_favorite_IDL_version_(not_idlde) ${OSIRIS_BACKBONE_DIR}/osiris_drp_backbone_startup.pro
This step is only necessary if you assign different IDL libraries (like astrolib, ICG, ...) to different IDL versions (for reasons of upward/backward compatibility). Of course the IDL version you use here must have access to the astrolib and ICG library.

This should work but i have not tested it with more users than myself.