NAME

Astro::FITS::HdrTrans::IRCAM - UKIRT IRCAM translations

SYNOPSIS

use Astro::FITS::HdrTrans::IRCAM;

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

DESCRIPTION

This class provides a generic set of translations that are specific to the IRCAM camera 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 a pattern match for /^IRCAM\d?/".

COMPLEX CONVERSIONS

to_DEC_SCALE

Pixel scale along the Declination axis in arcseconds. If the pixel scale is not defined in the PIXELSIZ or CDELT2 headers, then default to 0.08144 arcseconds for data taken after 19990901, or 0.286 arcseconds for older data. The value will always be positive.

from_DEC_SCALE

Generate the PIXELSIZ or CDELT2 header for IRCAM2 or IRCAM3 data respectively. The header will be returned in arcseconds, and will always be positive.

to_POLARIMETRY

Checks the filter name.

to_RA_SCALE

Returns the pixel scale along the RA axis in arcseconds. If the pixel scale is not defined in the PIXELSIZ or CDELT1 headers, then default to -0.08144 arcseconds for data taken after 19990901, or -0.286 arcseconds for older data. The value will always be negative.

from_RA_SCALE

Generates the PIXELSIZ or CDELT1 header for IRCAM2 or IRCAM3 data respectively. The header will be returned in arcseconds, and will always be negative.

to_SPEED_GAIN

For data taken before 22 November 2000, the SPD_GAIN header was not written. Obtain the SPEED_GAIN from the detector bias if the SPD_GAIN header is not defined. If the detector bias is between 0.61 and 0.63, then the SPEED_GAIN is Standard. Otherwise, it is Deepwell.

from_SPEED_GAIN

Translates the SPEED_GAIN generic header into the SPD_GAIN IRCAM-specific header. Note that this will break bi-directional tests as the SPD_GAIN header did not exist in data taken before 2000 November 22.

from_TELESCOPE

For data taken before 20000607, return 'UKIRT, Mauna Kea, HI'. For data taken on and after 20000607, return 'UKIRT,Mauna_Kea,HI'. Returned header is TELESCOP.

to_X_REFERENCE_PIXEL

Specify the reference pixel, which is normally near the frame centre. Note that offsets for polarimetry are undefined.

from_X_REFERENCE_PIXEL

Returns CRPIX1.

to_Y_REFERENCE_PIXEL

Specify the reference pixel, which is normally near the frame centre. Note that offsets for polarimetry are undefined.

from_X_REFERENCE_PIXEL

Returns 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.