NAME

Astro::FITS::HdrTrans::UKIRT - Base class for translation of UKIRT instruments

SYNOPSIS

  use Astro::FITS::HdrTrans::UKIRT;

DESCRIPTION

This class provides a generic set of translations that are common to instrumentation from the United Kingdom Infrared Telescope. It should not be used directly for translation of instrument FITS headers.

METHODS

can_translate

This implementation of can_translate is used to filter out a database row from an actual file header. The base-class implementation is used if the filter passes.

COMPLEX CONVERSIONS

These methods are more complicated than a simple mapping. We have to provide both from- and to-FITS conversions. All these routines are methods and the to_ routines all take a reference to a hash and return the translated value (a many-to-one mapping). The from_ methods take a reference to a generic hash and return a translated hash (sometimes these are many-to-many).

to_COORDINATE_TYPE

Converts the EQUINOX FITS header into B1950 or J2000, depending on equinox value, and sets the COORDINATE_TYPE generic header.

  $class->to_COORDINATE_TYPE( \%hdr );

from_COORDINATE_TYPE

A null translation since EQUINOX is translated separately.

to_RA_BASE

Converts the decimal hours in the FITS header RABASE into decimal degrees for the generic header RA_BASE.

Note that this is different from the original translation within ORAC-DR where it was to decimal hours.

from_RA_BASE

Converts the decimal degrees in the generic header RA_BASE into decimal hours for the FITS header RABASE.

  %fits = $class->from_RA_BASE( \%generic );

to_TELESCOPE

Sets the generic header TELESCOPE to 'UKIRT', so that it is SLALIB-compliant.

from_TELESCOPE

Sets the specific header TELESCOP to 'UKIRT'. Note that this will probably be sub-classed.

HELPER ROUTINES

These are UKIRT-specific helper routines.

_parse_date_info

Given either a ISO format date string or a UT date (YYYYMMDD) and decimal hours UT, calculate the time and return it as an object. Preference is given to the ISO version.

  $time = $trans->_parse_date_info($iso, $yyyymmdd, $uthr );

REVISION

 $Id$

SEE ALSO

Astro::FITS::HdrTrans, Astro::FITS::HdrTrans::Base

AUTHOR

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

COPYRIGHT

Copyright (C) 2007-2008 Science and Technology Facilities Council. Copyright (C) 2003-2007 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