GEMINI (December2012)    Gemini IRAF package v1.12beta    GEMINI (December2012)

Release date: December 13, 2012

This document describes the revisions relative to the Gemini IRAF package
v1.11.1.

The Gemini IRAF package v1.12beta is compatible with IRAF v2.14
(gemini_v112beta_for_iraf_2.14.tar.gz) and the 32-bit version of IRAF v2.15
(gemini_v112beta_for_iraf_2.15.tar.gz). This release will run under both IRAF
and PyRAF environments. Please note that PyRAF users who choose to upgrade to
IRAF v2.15 will need to use PyRAF v1.11. Please refer to
http://www.gemini.edu/sciops/data-and-results/processing-software/requirements 
for other requirements on your IRAF installation including other required
external packages.

WARNING!! The Gemini IRAF package v1.12beta is NOT compatible with the 64-bit
version of IRAF v2.15.

WARNING!! The Gemini IRAF package v1.12beta is NOT compatible with IRAF v2.16.

The binaries distributed with the package were built on Red Hat 9 and 
Mac OS X 10.6 Intel. See gemini_readme.txt for more information.

PRIMARY REVISIONS
=================

1) GSAOI: a) Added support for GSAOI

2) GNIRS: a) Updated the look-up tables to support the recent GNIRS upgrades

3) GEMINI: a) Removed the dependency on the external package gmisc

4) GEMTOOLS: a) Allowed gemcombine to accept MEF BPMs

5) GMOS: a) Added more realistic gain values for GMOS e2vDD fast read low gain
            mode

6) NIRI: a) Updated the look-up table to include improved values

DETAILS OF THE REVISIONS
========================

A multitude of minor bug fixes are included in this release. They will not be
listed here. Rather, only the most notable changes or those more likely to be
of interest to the user will be highlighted.

1) GSAOI
------------------
Instrument: GSAOI

    a) Data reduction support for GSAOI is provided in this version of the
       Gemini IRAF package.

       Examples of how to reduce GSAOI data can be obtained by running the task
       gsaoiexamples.

2) GNIRS
------------------
Instruments: GNIRS (parameter changes also affects NIFS, NIRI, Michelle, 
                    T-ReCS)

    a) The look-up tables in the gnirs$data directory were updated to include
       configurations required for the recent GNIRS upgrades.

       All users of the GNIRS package (GNIRS users of course, but also users of
       near-IR and mid-IR spectroscopy instruments) should initialize their
       uparm directory to avoid conflicts with old parameter files. To do
       this, either type "unlearn gnirs" at the IRAF or PyRAF prompt, or at the
       shell prompt type "rm uparm/*" from the iraf home directory (where the
       login.cl is located). 

3) GEMINI
------------------
Instruments: All

    a) The gmisc.ldisplay task was added to the gemtools package. The Gemini
       IRAF package v1.12beta is no longer dependent on the external package
       gmisc.

4) GEMTOOLS
------------------
Instruments: All

    a) The gemcombine task now accepts MEF BPMs. The bpmfile should be used to
       specify the name of the MEF BPM file. This change was made to support
       GSAOI.

5) GMOS
------------------
Instruments: GMOS North

    a) More realistic gain values for fast read low gain mode data taken with
       the new e2vDD CCDs and GMOS North have been included in the look-up
       table. The official values will be included in a later release, once
       they have been supplied by the GMOS team.

6) NIRI
------------------
Instruments: NIRI

    a) A number of improvements were made to NIRI specific values in the
       look-up table used to determine the wavelength solution.

SUMMARY OF ALL CHANGED PARAMETERS
=================================

If a task listed below is causing problems, it is very likely that the task is
accessing an old parameter file that does not contain the updated parameters
and/or values. To resolve the problem, the old parameter files for the Gemini
IRAF package must be removed from the uparm directory. To do this, at the IRAF
or PyRAF prompt, load gemini, then type "unlearn gemini". If it is not
desirable to remove all the old parameter files for the Gemini IRAF tasks, it
is possible to "unlearn" the individual task. 

Please see the appropriate help file for more information about the specific
parameter changes listed below.

    gemtools.gemhedit:
      - New parameter:      upfile

    gmos.gsat:
      - New parameter:      satdb

    gnirs.nsprepare:
      - New default value:  bpm = "gnirs$data/gnirsn_2012dec05_bpm.fits"

    gnirs.nsreduce:
      - Changed parameter:  fl_nscut --> fl_cut
      - New parameters:     gradimage (future support for F2 MOS)
                            outslitim (future support for F2 MOS)
                            edgediff (future support for F2 MOS)
                            refimage (future support for F2 MOS)
                            database (future support for F2 MOS)