Data Reduction Pipeline

Download

The latest version of the IDL-based (v1.02, optimised for IDL version 6.4) AF2/WYFFOS data reduction pipeline can be downloaded from the following link:

pipeline-current.tgz

For instance:

wget http://www.ing.iac.es/astronomy/instruments/af2/pipeline/pipeline-current.tgz

Installation

Full documentation for the pipeline is contained in the subdirectory /docs, including installation of the software.

Basically, the directory structure required to run the pipeline is shown in the figure below (extracted from the user manual). The pipeline directory contains the IDL pipeline procedures and the active pipeline control file (named control_data.txt). The subdirectory control_standards contains standard data files that are accessed by the pipeline software. Subdirectories containing the astron library of IDL subroutines and the interactive display tool ATV should be added if these are not already available on the user's IDL installation.

Below you will find the installation instructions and examples:

1. Untar and uncompress the downloaded file:

   tar zxvf pipeline-current.tgz

2. Check the enviromental variable IDL_PATH.

   If you are using a c shell (csh, tcsh) type:

   printenv IDL_PATH

   If IDL_PATH doesn't exist, then set it to the directory containing the pipeline IDL routines, for example:

   setenv IDL_PATH "/home/user/pipeline_directory/pipeline"

   Otherwise, add the directory name to the existing IDL_PATH variable:

   setenv IDL_PATH "${IDL_PATH}:+/home/user/pipeline_directory/pipeline"

   If you are using a bourne shell (sh, ksh, bash):

   echo $IDL_PATH

   If IDL_PATH doesn't exist, then set it to the directory containing the pipeline IDL routines, for example:

   IDL_PATH=/home/user/pipeline_directory/pipeline

   Otherwise, add the directory name to the existing IDL_PATH variable:

   IDL_PATH=$IDL_PATH:/home/user/pipeline_directory/pipeline

   You might want to add the above variable declaration to you login files.

3. ATV is an IDL program for display and analysis of astronomical images written and maintained by Aaron Bath. It is similar in appearance and has many of the functions of the SAO image utility ds9.Change to directory pipeline (for instance, home/user/pipeline-v1.0/pipeline/) and download the right version of the ATV procedure. Version 2.3 works fine with Linux Fedora 14 and IDL v6.4. You can use wget to download the atv.pro file:

   wget http://www.physics.uci.edu/~barth/atv/2.3/atv.pro

4. Download the Coyote library to the directory containing the IDL pipeline routines. Download and unzip the following file (Linux Fedora 14 and IDL 6.4):

   wget http://www.idlcoyote.com/programs/zip_files/coyoteprograms.zip

   IMPORTANT: The Coyote library might issue an error if IDL and X11 window manager are not handling the backing-store graphic mechanism properly (read more here). The problem can be fixed if you type the following at the IDL prompt:

   IDL>Device,RETAIN=2

   This can be added to the user's IDL_STARTUP file, if using the c-shell:

   setenv IDL_STARTUP ~/mystartup.pro

   And add IDL>Device,RETAIN=2 to the file mystartup.pro.

5. Download the Craig Markwardt's cmps_form.pro for setting postscript parameters to the directory containing the IDL pipeline routines:

   wget http://cow.physics.wisc.edu/%7Ecraigm/idl/down/cmps_form.pro

6. Download and install the astrolib library from http://idlastro.gsfc.nasa.gov/ftp/.

   wget http://idlastro.gsfc.nasa.gov/ftp/astron.tar.gz

   On the public ING linux computers, just type 'astrolib' at the IDL prompt.

7. Change to the directory containing the IDL pipeline routines and start IDL. Type 'gui' to start the GUI window of the AF2 pipeline software.