
Astro::FITS::HdrTrans::UKIRTDB - UKIRT Database Table translations

%generic_headers = translate_from_FITS(\%FITS_headers, \@header_array); %FITS_headers = transate_to_FITS(\%generic_headers, \@header_array);

Converts information contained in UKIRTDB FITS headers to and from generic headers. See Astro::FITS::HdrTrans for a list of generic headers.

Determine if this class can handle the translation. Returns true if the TELESCOP is "UKIRT" and there is a "FILENAME" key and a "RAJ2000" key. These keywords allow the DB results to be disambiguated from the actual file headers.
$cando = $class->can_translate( \%hdrs );

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)
Sets the INST_DHS header.
Converts either the EXPOSED or DEXPTIME FITS header into the EXPOSURE_TIME generic header.
Converts the EQUINOX FITS header into B1950 or J2000, depending on equinox value, and sets the COORDINATE_TYPE generic header.
Converts either the SANGLE or the SLIT_PA header into the SLIT_ANGLE generic header.
Converts either the SLIT or the SLITNAME header into the SLIT_NAME generic header.
Converts either the STANDARD header (if it exists) or uses the OBJECT or RECIPE headers to determine if an observation is of a standard. If the OBJECT header starts with either BS or FS, or the DR recipe contains the word STANDARD, it is assumed to be a standard.
Strips the optional 'Z' from the DATE-OBS header, or if that header does not exist, combines the UT_DATE and RUTSTART headers into a unified UTSTART header.
Converts the UTSTART generic header into UT_DATE, RUTSTART, and DATE-OBS database headers.
Strips the optional 'Z' from the DATE-END header, or if that header does not exist, combines the UT_DATE and RUTEND headers into a unified UTEND header.
Converts the UTEND generic header into UT_DATE, RUTEND and DATE-END database headers.
Converts the decimal hours in the FITS header RABASE into decimal degrees for the generic header X_BASE.
Converts the decimal degrees in the generic header X_BASE into decimal hours for the FITS header RABASE.
Converts the decimal hours in the FITS header RABASE into decimal degrees for the generic header RA_BASE.
Converts the decimal degrees in the generic header RA_BASE into decimal hours for the FITS header RABASE.

Handle the case where DATE_OBS and/or DATE_END are given, and convert them into DATE-OBS and/or DATE-END.
_fix_dates
_parse_date
Parses a string as a date. Returns a
Time::Pieceobject.$time = _parse_date( $date );Returns
undefif the time could not be parsed. Returns the object unchanged if the argument is already aTime::Piece.It will also recognize a Sybase style date: 'Mar 15 2002 7:04AM' and a simple YYYYMMDD.
The date is assumed to be in UT.

$Id$

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

Brad Cavanagh <b.cavanagh@jach.hawaii.edu>, Tim Jenness <t.jenness@jach.hawaii.edu>

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