VLT Instrument Pipelines

Latest News:

May 5, 2015: MUSE pipeline recipes v1.0.4 are available!

This is a maintenance release of the MUSE recipe package. It provides updated static calibrations suitable for data taken after a hardware intervention on the 1st of April 2015.
Read more...

April 21, 2015: P-95 releases of pipeline packages are available!

For most instrument pipelines an updated version is now available. For details please have a look here.

For Mac users these pipeline packages (with and without EsoReflex support) are now also available as MacPorts packages for Mac OSX 10.9!
For details please have a look a the installation instructions

January 28, 2015: MUSE pipeline recipes v1.0.1 are available!

This is a maintenance release of the MUSE recipe package, addressing a number of EsoReflex workflow and documentation related issues.
Read more...

Introduction

In collaboration with the various instrument consortia, the Pipeline Systems Department has undertaken to implement data reduction pipelines for the most commonly used VLT/VLTI instrument modes. These data reduction pipelines have three main purposes:

  • Data quality control - pipelines are used to produce the quantitative information necessary to monitor instrument performance (see the ESO Quality Control web pages for more information).
  • Master calibration product creation - pipelines are used to produce master calibration products (e.g. combined bias frames, super-flats, wavelength dispersion solutions).
  • Science product creation - using pipeline-generated master calibration products, science products are produced for supported instrument modes (e.g. combined ISAAC jitter stacks; bias-corrected, flat-fielded FORS images, wavelength-calibrated UVES spectra). The accuracy of the science products can be limited both by the quality of the available master calibration products and by the algorithmic implementation of the pipelines themselves. In particular, adopted reduction strategies may not be suitable for all scientific goals. Therefore, ESO assumes no responsibility for the usefulness of reduced data for any specific scientific project.

Pipelines Running Environments: EsoReflex, Gasgano and Esorex

EsoReflex is the recommended way to reduce ESO data. It automatically organizes input files according to their category and runs the entire reduction chain at the push of a button. It supports break points in the reduction sequence in order to inspect and interact with intermediate and final products and rerun the corresponding step if necessary. The supported instrument modes are identified by a blue background color in the pipelines table

Gasgano is a Java-based data file organizer developed and maintained by ESO. It can be used to manage and organize in a systematic way the astronomical data observed and produced by all VLT compliant telescopes. Gasgano is a graphics-based software tool for organising and viewing data files produced by the VLT Control System. Gasgano offers functionalities for data viewing, grouping, sorting, classification, searching, and filtering of data. And, of course, Gasgano will run any requested CPL recipe on the selected data.

Esorex, a command-line utility for running pipeline recipes is also available. It may be embedded by users at their home institute into data reduction scripts for the automation of processing tasks.

Both Gasgano and Esorex are included in the pipeline public release packages.

EsoReflex-based Pipeline workflows

The pipelines released with a EsoReflex workflow are identified by the blue background rows in the pipelines table.

Installation Instructions

We currently provide several ways to install one or several pipelines on your machine. The recommended installation procedure depends on whether you are working on a Mac OSX or on Linux and whether you want to use EsoReflex based pipelines or not.

MacPorts

For Apple Mac OS X 10.9 or newer, it is recommended to install it with MacPorts (whether you use EsoReflex based pipelines or not). Refer to the instructions provided here.

install_esoreflex

Otherwise, you can install EsoReflex based pipelines on a Mac OSX or on Linux with the following steps (it includes EsoReflex itself, the pipelines and demo data sets):

install_pipeline / install_pipelinekit

Finally, you also can follow the basic multiple pipelines installation instructions on a Mac OSX or on Linux:
  • Download the desired pipeline kits from the Package column in the table below into an empty, temporary directory.
  • Download the Pipeline-kit installer into the same directory.
  • If necessary, make it executable: chmod u+x install_pipelinekit
  • Execute the command: ./install_pipelinekit *-kit-*.*
  • After the installation the temporary directory with its contents can be deleted.

Pipeline Releases Based on the most Recent CPL Release

 

The table below lists pipelines delivered with CPL version 6.6.They can be installed together using this procedure.

 

Instrument Release Notes Package User Manual Cookbook Additional Documents Additional Datasets EsoReflex Status
AMBER 2015-03-06 4.3.3 4.3.2
Operational on hold
CRIRES 2015-03-11 2.3.2 1.13
Cookbook
Operational on hold
DETMON 2015-03-06 1.3.0 1.3.0
Operational on hold
EFOSC 2015-02-26 2.2.3 1.0
Demo Data
End of maintenance
FORS 2015-04-17 5.0.11 5.1
Demo Data (29 MB)
Tutorial: 1.0 (FORS-IMG)
Tutorial: 1.0 (FORS-PMOS)
Tutorial: 1.8 (FORS-SPEC)
Demo Data: 0.8
Active
GIRAFFE 2015-04-15 2.14 2.14
Cookbook
Standard Calibration Files page
Active
HAWKI 2015-04-20 1.8.18 1.11
Demonstration Package (2,5 GB)
Active
ISAAC 2015-04-17 6.1.5 1.4
Static Calibration Files (50 MB)
End of maintenance
KMOS 2015-04-09 1.3.12 2.16
Tutorial: 1.2
Demo Data: 1.0
Active
MIDI 2015-04-15 2.8.4 2.8.3
End of maintenance
MUSE 2015-05-05 1.0.4 Cookbook
MUSE IFU 6 trace tables
Leagacy MUSE static calibrations
Tutorial: 5.0
Demo Data: 1.1
Active
NACO 2015-03-11 4.4.0 1.1
Operational on hold
SINFONI 2015-03-10 2.6.0 19.2
ADA IV 2006 paper
Calibration Database Example (255 MB)
Demonstration Package (1.2 GB)
Tutorial: 1.2
Demo Data: 0.2
Active
SOFI 2015-04-17 1.5.6 1.2
End of maintenance
SPHERE 2015-03-10 0.15.0 Active
UVES 2015-04-07 5.5.2 18.3 (UVES-FIBRE)
22.9 (UVES)
Demonstration Package (2.0 GB)
Tutorial: 6.4 (UVES)
Tutorial: 1.3 (UVES-FIBRE)
Demo Data: 4.4
Operational on hold
VIMOS 2015-02-20 2.9.15 6.10
Demonstration Package (1.7 GB)
Tutorial: 2.2 (VIMOS-IFU)
Tutorial: 1.2 (VIMOS-MOS)
Demo Data: 0.4
Active
VISIR 2014-04-09 3.5.1 1.4
Active
XSHOOTER 2015-03-10 2.6.0 12.5
Additional NIR telluric model calatog (190 MB)
Tutorial: 2.4
Demo Data: 1.2
Operational on hold

Pipelines Status

The pipeline status determines the level of ESO support in fixing the software. For any help with installation and usage of a pipeline, please contact the helpdesk ticketing system (e-mail to usd-help@eso.org or "Ask for help" link in he User Portal homepage). ESO internal (operations) users should request support from the pipeline developers team using JIRA. Here are the possible entries:
  • Active: Pipelines that are affected by a data product upgrade are considered active in the sense that a project team is actively working on them. These pipelines are fully supported and have the highest priority for support. The support consists in prompt evaluation of all requests.
  • Operational on hold: Pipelines that are on hold are not under active development and are of lower priority for support. Pipelines are put into this status when they are considered to be essentially completed, i.e. no enhancements or upgrades are currently under way. The software support consists in porting these pipelines to new CPL versions, carrying out emergency repairs and fixing trivial problems. The User Support Department will evaluate and answer if possible the requests for help received via helpdesk (usd-help@eso.org), but by default there will be no available support from pipeline developers.
  • End of maintenance: Pipelines in this status are the lowest priority for support. The only work performed on these pipelines is to make sure they can still run in the current ESO environment. The User Support Department evaluates and answers if possible the requests for help received via helpdesk (usd-help@eso.org). Tickets reporting problems on the pipeline will not receive any software support.

 

Additional tools for data visualisation and analysis.

 

Previous Pipeline Releases

The Pipeline Systems Department also makes these data reduction pipelines available to the user community. They are based on older versions of CPL and can in general not be installed together.

Pipeline
With links to the instrument pages
Release Information Release File
Includes CPL,Gasgano,EsoRex,
and static calibration data
Users Manual and Documentation Data Sets
EFOSC 2.2.2 (2011-04-07) 2.2.2 (2011-04-07) EFOSC User Manual 1.0 (2011-02-02) Static Calibration Tables (included in kit) Demo Data (100 MB)
UVES (DISCLAIMER) 2.9.10 (2012-06-13) 2.9.10 (MIDAS based) UVES Pipeline User Manual 2.9.10
FLAMES-UVES Pipeline User Manual 2.9.10
A set of reference and master calibration data is included in the pipeline package.
DISCLAIMER:
MIDAS based release is offered with very limited support. We recommend users to use the EsoReflex based kit release.

Publications, Reference Documents, and Links


A list of Data Reduction Frequently Asked Questions is available.

The ESO Quality Control Group processes VLT data and monitors the instrument and data quality and also provides a summary of current pipeline status.

A Science Data Product Forum is available to exchange ideas, methods, software…

If you make use of EsoReflex workflows in a scientific publication, please consider citing EsoReflex. You may reference the following paper: Automated Data Reduction Workflows for Astronomy: The ESO Reflex Environment, 2013, Freudling, W., et al., Astron.Astrophys., 559, A96 (Bibtex entry)

The latest applicable version of the Data Flow for VLT/VLTI Instruments Deliverable Specifications (VLT-SPE-ESO-19000-1618) is version 3.