Sampo project - Reflex - Installation

The ESO Recipe Flexible Execution Workbench

Installation instructions

This page includes instructions for Reflex installation. The only prerequisites are that ESO Scisoft VI and Java 1.5 SDK including Java Runtime Environment (or later) are installed. Instructions for installing ESO Scisoft or Java 1.5 are not given. Root access is not required, and all software will be installed any directory where user have a write access and sufficient disc space available.

Required hardware for Reflex

  • A modern Linux or Mac OSX computer with at least 1 GB memory and sufficient disk space for data
  • Supported Operating systems:

    • Fedora Core 3/4/5/6
    • Red Hat Enterprise Linux 4
    • Ubuntu Linux
    • Mac OSX Intel **/*
    • Mac OSX Power PC *

Required software for Reflex

  • Java 1.5 SDK including Java Runtime Environment (or later) is required.
  • ESO Scisoft VI (or later) is required. * In Mac OSX/Intel Scisoft is corrupted for building Reflex
  • To integrate PyRAF into Reflex, two steps are required. First create the as you would when using IRAF. Secondly, to communicate with the irafterm, Reflex needs currently a patch for PyRAF.

Download Reflex kit

The Reflex kit contains all necessary pipeline products and third-party software for the Reflex installation. It is strongly recommended to install ESO Reflex from the Reflex-kit installation package. Other installation methods should be used only in case of unsuccesful reflex-kit installation or in case of updating individual installation packages. The disk space required for installation is approximately 95 MB.

warning.gif If you would like to test the current ESO Reflex beta release please contact and we will provide you with a link to the kit.

The Reflex kit contains the following packages

  • reflex-1.1-beta-rc1.tar.gz
  • cfitsio-2510.tar.gz
  • qfits-6.2.0.tar.gz
  • cpl-4.0.tar.gz
  • esorex-3.6.5.tar.gz
  • amber-2.4.1.tar.gz
  • fors-3.1.7.tar.gz
  • graphviz-2.14.1.tar.gz
with the following pipeline calibration file(s):
  • fors-calib-3.1.7.tar.gz
  • amber-calib-2.4.1.tar.gz

Installing Reflex kit

warning.gif Important:

Before starting the installation be sure if your JAVA_HOME environment variable is set correctly. The incorrect JAVA_HOME setting may cause damage for building the Java CPL interface, which is mandatory for the Reflex usage.

* Mac OSX default JAVA_HOME = /Library/Java/Home

** Mac OSX Intel users should be careful before building Reflex with current Scisoft Mac OSX distribution. Fontconfig-2.3.2 and freetype-2.2.1 libraries are not compatible with current Graphviz package. The solution to Mac OSX Scisoft for Reflex to build is to avoid the usage of these libraries. The Scisoft Setup script will add these libraries in to system environment variables. Be sure the Setup script is not executed before starting ESO Reflex installation. This can be checked up by env command. More complex solution is to rename the directories:

fontconfig-2.3.2 and freetype-2.2.1

in /scisoft/i386/Packages to something else, so that the configure script doesn't find them - and uses the correct ones in Mac OSX.


1. unpack reflex-kit-1.1-beta-rc1 and 'cd' into it

tar zxvf reflex-kit-1.1-beta-rc1.tar.gz

cd reflex-kit-1.1-beta-rc1

2. Install package


and follow the instructions

warning.gif Note:

In order to use Reflex you need set the PATH environment variable. "csh" and "tcsh" users should invoke the command:

setenv PATH ${PATH}:"$prefixdir"/bin

and users of the "bash" shell should use:

export PATH=$PATH:"$prefixdir"/bin

where "$prefixdir" is the selected installation location of ESO Reflex

These commands may be conveniently added to an appropriate startup file such as .cshrc or .tcshrc (for csh and tcsh) and .profile (for bash) or the system-wide equivalents.

If you are unsure which shell you are using type:

echo $SHELL

After setting the PATH, please type "reflex" to start ESO Reflex.

Download Reflex test data

Test data for AMBER

Test data for FORS

Reporting bugs

  • Please send email to to report any bugs you may encounter.
  • Please provide instructions (as detailed as possible) to reproduce the bug
  • Also include the log file located under reflex-current/log in your report