NAME

Astro::FITS::HdrTrans::UIST - UKIRT UIST translations

SYNOPSIS

use Astro::FITS::HdrTrans::UIST;

%gen = Astro::FITS::HdrTrans::UIST->translate_from_FITS( %hdr );

DESCRIPTION

This class provides a generic set of translations that are specific to the UIST camera and spectrometer of the United Kingdom Infrared Telescope.

METHODS

this_instrument

The name of the instrument required to match (case insensitively) against the INSTRUME/INSTRUMENT keyword to allow this class to translate the specified headers. Called by the default can_translate method.

$inst = $class->this_instrument();

Returns "UIST".

COMPLEX CONVERSIONS

to_DEC_SCALE

Pixel scale in degrees. For imaging, the declination pixel scale is in the CDELT1 header, and for spectroscopy and IFU, it's in CDELT3.

from_DEC_SCALE

Generate the PIXLSIZE header.

to_ROTATION

ROTATION comprises the rotation matrix with respect to flipped axes, i.e. x corresponds to declination and Y to right ascension. For other UKIRT instruments this was not the case, the rotation being defined in CROTA2. Here the effective rotation is that evaluated from the PC matrix with a 90-degree counter-clockwise rotation for the rotated axes. If there is a PC3_2 header, we assume that we're in spectroscopy mode and use that instead.

to_X_REFERENCE_PIXEL

Use the nominal reference pixel if correctly supplied, failing that take the average of the bounds, and if these headers are also absent, use a default which assumes the full array.

from_X_REFERENCE_PIXEL

Always returns the value as CRPIX1.

to_Y_REFERENCE_PIXEL

Use the nominal reference pixel if correctly supplied, failing that take the average of the bounds, and if these headers are also absent, use a default which assumes the full array.

from_Y_REFERENCE_PIXEL

Always returns the value as CRPIX2.

REVISION

$Id$

SEE ALSO

Astro::FITS::HdrTrans, Astro::FITS::HdrTrans::UKIRT.

AUTHOR

Malcolm J. Currie <mjc@star.rl.ac.uk> Brad Cavanagh <b.cavanagh@jach.hawaii.edu>, Tim Jenness <t.jenness@jach.hawaii.edu>.

COPYRIGHT

Copyright (C) 2008 Science and Technology Facilities Council. Copyright (C) 2003-2005 Particle Physics and Astronomy Research Council. All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either Version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful,but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.