...."; # # ##### submenu structure below 4th level, activate only if applicable # $menufile = "menu4eso.php"; # # ##### Welcome Notice # $welcomenotice = "This message appears as welcome notice under the menu"; # # ##### Author and AuthorEmail to create a "Send comments to... " instead of the # ##### the standard Contact Form link. # $author = "ESO User Support Department"; # $authorEmail = ""; # # ******************************************************************************************************************** # do not delete or change these lines include 'frame_top.php'; ?>

The pipeline recipes v have been released!

Home About Documentation RPM Installation MacPorts Installation Source Kits Support

This is a maintenance release of the GIRAFFE pipeline recipes.

Changes:

2.18.4 (2025-07-31):
  • Updating EDPS workflows and ADARI reports.
2.18.0 (2025-03-12):
  • Adding EDPS workflows and ADARI reports. Adding QC parameters to the products.
2.16.12 (2024-05-15):
  • Fixed reflex workflow bug with recent python versions.
2.16.11 (2023-05-31):
  • Update for latest CPL version.
2.16.10 (2022-05-19):
  • Update for latest CPL version.
2.16.8 (2021-06-01):
  • Update for latest CPL version.
  • Updated standard stars in static calibrations.
  • Updates for macOSX 11 support.
2.16.7 (2020-06-03):
  • Update of the Reflex tutorial.
  • Updated the Reflex workflow to be compatible with Python 3 and Python 2, and with Reflex 2.10.
2.16.5 (2019-05-20):
  • Do not treat simultaneous calibration fibers as ancilliary data when creating products in SDP format.
  • Improved version of the Reflex workflow:
    • Improved science and standard star interactive GUIs including implementation of (optionally-interactive) sky-subtraction.
    • Support for multiple grouping (or no grouping) strategies in a single workflow.
2.16.3 (2018-04-20):
  • Fixed value and unit of the TUCD1 FITS keyword in the phase 3 products.
2.16.2 (2017-04-26):
  • Improved version of the EsoReflex workflows with interactivity.


The distributed recipes can be used for all three observing modes of the GIRAFFE spectrograph:

Together with the data processing modules, we also provide two standalone applications for running them:

GIRAFFE pipeline recipes public version:

The public version of the GIRAFFE pipeline recipes is , and it is included in the pipeline distribution kit .tar.gz together with the following packages:

System Requirements

This release of the GIRAFFE pipeline kit is verified and supported on the VLT target platforms: It is also verified that the pipeline kit can be built on the following platforms (x86_64, unless specified otherwise):

Installing and running the pipeline recipes

There are several ways to install the pipeline on your machine. The recommended installation procedure depends on whether you are working on macOS or on Linux.

Installation using RPM repositories

For Fedora 38-40, and CentOS 7 it is recommended to install the pipeline from our RPM repository.

Please refer to the instructions provided here.

"; echo "dnf list esopipe-*contrib* # (Fedora 38 or newer)"; } ?>

Installation using MacPorts repositories

For Apple macOS 12-15, it is recommended to install the pipeline with MacPorts.

Please refer to the instructions provided here.

"; echo "sudo port install 'esopipe-*contrib*'"; } ?>

Installation using the EsoReflex installation procedure"; echo "

Please refer to EsoReflex Software Prerequisites and Installation Instructions for detailed instructions

"; if ($pipe_reflex_addons) { echo "

User-contributed workflows are available for $pipe_name $pipe_version and they are installed automatically with the standard instrument workflows when using the install_esoreflex script.
"; echo "Please note that these user-contributed workflows may have additional, non-standard software dependencies! These must be installed by the users themselves. For detailed information on additional software dependencies please refer to the documentation of the individual workflows!

"; } } ?>

Installation using the public pipeline kit

To use the pipeline recipes you will need to retrieve the pipeline distribution kit, unpack and install it.

Prerequisites:

Installation procedure:

  1. Change directory to where you want to retrieve the pipeline recipes package. It can be any directory of your choice but not: $HOME/gasgano
    $HOME/.esorex
  2. Download the software and the static calibration data necessary for running the pipeline recipes:
      GIRAFFE pipeline kit version   (37 MB).
  3. Unpack the distribution file, using the following command:
        tar -zxvf .tar.gz
  4. Install: after moving into the top level directory of the unpacked distribution,
        cd it is recommended to perform the installation using the supplied installation script:
        ./install_pipeline This may take a few minutes. Please be patient!

    Note for macOS users:
    On macOS the environment variable JAVA_HOME should be set to JAVA_HOME=/System/Library/Frameworks/JavaVM.framework/Versions/CurrentJDK/Home prior to running the installation script in order to avoid compilation errors during the installation.

    By default the script will install the GIRAFFE 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_pipeline
    I am about to install the following software packages:
      gasgano-.tar.gz
      cfitsio-.tar.gz
      wcslib-4.24.tar.bz2
      fftw-3.3.4.tar.gz
      cpl-.tar.gz
      esorex-.tar.gz
      -.tar.gz

    - with the following pipeline calibration file(s):
      -calib-.tar.gz

    The software installation will be organised in bin/, lib/ and include/
    directories, while the calibration files will be installed in a calib/ directory.

    Where should I install the software packages ? [/home/dummy] /home/dummy/pipelines
    Where should I install the pipeline calibration files ? [/home/dummy/pipelines] /home/dummy/calibrations
     In this case the software is installed under the directory /home/dummy/pipelines and the static calibration tables under /home/dummy/calibrations/calib/giraf-
    The only exception to all this is the Gasgano tool, that will always be installed under the directory $HOME/gasgano Note that the installer will move an existing $HOME/gasgano directory to $HOME/gasgano.old before 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).

    Alternatively, it is possible to perform a manual installation of the individual components (experienced users only): the README file located in the top installation directory contains more detailed information about a step-by-step installation.

Setup of the GIRAFFE calibration files

Previously a link to the GIRAFFE Standard Calibrarion Data Sets was provided here. Since all the needed calibration products are available through the ESO archive, these standard calibration data sets are obsolete and are no longer provided here.

Using the GIRAFFE pipeline recipes

Using Gasgano

  1. To run the Gasgano GUI, just add $HOME/gasgano/bin to your PATH environment variable:
        export PATH="$HOME/gasgano/bin:"$PATH You should also define an environment variable CPLDIR to point to the same path specified for the installation. Possible files to update are:
        $HOME/.bashrc
        $HOME/.profile     Finally, enter the command
        gasgano
  2. If the Gasgano main panel appears, then you have successfully installed Gasgano. Make sure, however, that the expected Gasgano release is running: the version number is listed at the top of the main Gasgano panel.
  3. Refer to the Gasgano User's Manual to learn how to browse data and run pipeline recipes. Refer to the GIRAFFE Pipeline User Manual for detailed information about the recipes usage.

Using EsoRex

  1. 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).
  2. Refer to the EsoRex web page for details about the related features and options.

Documentation

The GIRAFFE Pipeline User Manual (ca. 869 kB, 95 pages), is available here for download. Note that the manual is also included in the GIRAFFE pipeline kit.

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.

Bug Reports

If you experience an unexpected behavior of any component of the GIRAFFE 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 current GIRAFFE pipeline release, in chapter 5 of the pipeline manual.

For any other issues or requests, please contact the ESO User Support Department mentioning GIRAFFE pipeline in the subject, describing: