A release of the VIMOS pipeline recipes is now available !
A release of the VIMOS pipeline recipes is now available.
Together with the data processing modules, we also provide standalone applications for running them:
- Reflex, a GUI which provides an easy and flexible way of runing pipeline execution workflows.
- Gasgano, a GUI for data browsing and organisation, providing an intuitive and comprehensive interface to pipeline recipes that are based on the ESO Common Pipeline Library (CPL).
- EsoRex, a command-line driven utility to launch pipeline recipes, which can be used either as an interactive tool, or can be embedded into scripts for automating some of the data reduction tasks.
VIMOS pipeline recipes public version:
The public version of the VIMOS pipeline recipes is
2.9.9, and it is included in the pipeline
vimos-kit-2.9.9.tar.gz together with
the following packages:
- the CFITSIO library, version 3310
- the Common Pipeline Library (CPL), version 6.3
- Gasgano version 2.4.3
- EsoRex, version 3.10
- Third-party libraries used by CPL (wcslib, fftw)
VIMOS pipeline recipes System RequirementsThe VIMOS pipeline kit version 2.9.9 is verified and supported on the VLT target platform:
- Scientific Linux 5.3 (Intel), using gcc v. 4.2.4
- Fedora 18 (Intel Core 2 64 bits), using gcc v. 4.6.3
- Scientific Linux 5.3 (Athlon), using gcc v. 4.1.2
- SLC 5.3, i386, gcc4.4
- SLC 5.5, amd64, gcc4.4
- SLC 6.3, amd64, gcc4.4
- Ubuntu 10.04, i386, gcc4.4
- Ubuntu 10.04, amd64, gcc4.4
- Ubuntu 10.10, amd64, gcc4.6
- Ubuntu 12.04, i386, gcc4.6
- Ubuntu 12.04, amd64, gcc4.6
- Ubuntu 12.10, i386, gcc4.7
- Ubuntu 12.10, amd64, gcc4.7
- Ubuntu 13.04, i386, gcc4.7
- Ubuntu 13.04, amd64, gcc4.7
- Debian 6 (Squeeze), i386, gcc4.4
- Debian 6 (Squeeze), amd64, gcc4.4
- Fedora 11, i386, gcc4.4
- Fedora 16, i386, gcc4.6
- Fedora 16, x86_64, gcc4.6
- Fedora 17, i386, gcc4.7
- Fedora 17, x86_64, gcc4.7
- Fedora 18, i386, gcc4.7
- Fedora 18, x86_64, gcc4.7
- Intel Mac 10.6, i386, gcc4.2, Apple clang 1.7
- Intel Mac 10.8, amd64, gcc4.2, Apple clang 4.2
- OpenSuse 12.1, amd64, gcc4.6
Installing and running the VIMOS pipeline recipes 2.9.9There are two ways to install the pipeline: within the Reflex environment or using the pipeline kit.
Installation using the Reflex installation procedure
Please refer to Reflex workflows release notes for detailed instructions
Installation using the public pipeline kit
To install the VIMOS pipeline recipes 2.9.9 you will need to retrieve the pipeline distribution kit, unpack and install it.
- One of the C++ compilers listed above, and standard GNU tools including make.
- To install the latest graphical front-end Gasgano version 2.4.3 and configure it properly the Java Developer Kit (JDK) version 1.6.0 must be available on your system. If it is not, you may download it from the official Sun Java page distribution, for example http://developer.apple.com/java/download/ for a Mac installation or http://java.sun.com/javase/downloads/ for Solaris and Linux platforms installations. On some modern Linux distributions like Ubuntu you may install the JDK simply by choosing it from the software installer. Furthermore, the related java executable must be in your PATH. You may install and run Gasgano under other operating systems or use a different JDK version, but ESO cannot guarantee that Gasgano will work correctly in such case. Gasgano is known to be resource-intensive: see details of memory and CPU usage in Appendix A of the Gasgano User's Manual.
- In order to retrieve the distribution kit, you may need to configure your Web browser so that it knows how to deal with the files we distribute, i.e. gzipped tar files (.tar.gz filename extension). If you click on one of the links below, your browser should display a file selection panel; if you end up instead with a page full of strange characters, you may try clicking on the link while holding the Shift key down, or configure your browser.
- Change directory to where you want to retrieve the VIMOS pipeline
recipes 2.9.9 package. It can be any directory of your
choice but not:
- Download the software and the static calibration data
(line catalogs etc.) necessary for running the pipeline recipes:
- VIMOS pipeline kit version 2.9.9 (ca. 49 MB).
- Unpack using for example the following command:
tar xzf vimos-kit-2.9.9.tar.gzNote that the size of the installed software (including Gasgano) together with the static calibration data is about 119 MB.
- Install: after moving into the installation directory,
cd vimos-kit-2.9.9it is recommended to perform the installation using the supplied installer script:
./install_pipeline(BEWARE: The installation may take several minutes). By default the script will install the VIMOS recipes, Gasgano, EsoRex, all the necessary libraries, and the static calibration tables, into a directory tree rooted at $HOME. A different path may be specified as soon as the script is run. For instance (user input is boldfaced):
$ ./install_pipelineIn this case the software is installed under the directory
I am about to install the following software packages:
Where should I install the software packages ? [/home/userid] /home/dummy/pipelines
Where should I install the pipeline calibration files ? [/home/dummy/pipelines] /home/dummy/calibrations
/home/dummy/pipelinesand the static calibration tables under
/home/dummy/calibrations/vimosThe only exception to all this is the Gasgano tool, that will always be installed under the directory
$HOME/gasganoNote that the installer will move an existing
$HOME/gasgano.oldbefore the new Gasgano version is installed.
Important: the installation script would ensure that any existing Gasgano and EsoRex setup would be inherited into the newly installed configuration files (avoiding in this way any conflict with other installed instrument pipelines).
Please follow the instructions shown at the end of a successful installation script: they will indicate how to set your PATH and CPLDIR variables in your machine in order to run the pipeline.
Alternatively, it is possible to perform a manual installation (experienced users only): the README file located in the top installation directory contains more detailed information about a step-by-step installation.
Executing the VIMOS pipeline 2.9.9
- To run the Reflex workflow, please refer to the VIMOS workflow tutorial available in this table under column Documentation.
- To run the Gasgano GUI, just add
$HOME/gasgano/binto your PATH environment variable:
export PATH="$HOME/gasgano/bin:"$PATHYou should also define an environment variable CPLDIR to point to the same path specified for the installation. Possible files to update are:
$HOME/.profileFinally, enter the command
- If the Gasgano main panel appears, then you have successfully installed Gasgano. Make sure, however, that the expected Gasgano 2.4.3 release is running: the version number is listed at the top of the main Gasgano panel.
- Refer to the Gasgano User's Manual to learn how to browse data and run pipeline recipes. Refer to the VIMOS Pipeline User Manual for detailed information about the recipes usage.
- The EsoRex executable should be available in the bin directory under your installation path (see above). The PATH environment variable should be upgraded accordingly (similarly as done for Gasgano).
- Refer to the EsoRex web page for details about the related features and options.
The VIMOS Pipeline User Manual (6.9) (ca.6.9 MB, 251 pages), is available here for download. Note that the manual is also included in the VIMOS pipeline kit.
The Reflex Users' Manual is availale for download
The GASGANO Users' Manual (~1.2 Mb, 66 pages) is available for download in the Gasgano web page.
On the EsoRex web page some online documentation about EsoRex can be found.
The CPL manuals are available on the CPL web pages.
In case of problems when opening the documents directly from your web browser, the files may be first saved on disk, and then opened with Acrobat Reader.
If you experience an unexpected behavior of any component of the VIMOS pipeline recipes package, please, first verify that you are using one of the above mentioned supported platforms and refer to the list of known problems and limitations in the pipeline manual of the current VIMOS pipeline release.
For any other issues or requests, please, send a report to the ESO User Support Department, describing:
- the VIMOS pipeline version (currently 2.9.9), and the version of other components (e.g., Gasgano, EsoRex, ...) you are using
- the version of your OS and C compiler.
- the exact sequence of actions that were performed before the problem occurred
- what were precisely the symptoms and the possible error message(s)
- whether the problem is repeatable