NAME

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

SYNOPSIS

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

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

DESCRIPTION

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

METHODS

can_translate

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 );

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_INST_DHS

Sets the INST_DHS header.

to_EXPOSURE_TIME

Converts either the EXPOSED or DEXPTIME FITS header into the EXPOSURE_TIME generic header.

to_COORDINATE_TYPE

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

to_GRATING_NAME

to_GRATING_WAVELENGTH

to_SLIT_ANGLE

Converts either the SANGLE or the SLIT_PA header into the SLIT_ANGLE generic header.

to_SLIT_NAME

Converts either the SLIT or the SLITNAME header into the SLIT_NAME generic header.

to_SPEED_GAIN

to_STANDARD

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.

to_UTDATE

to_UTSTART

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.

from_UTSTART

Converts the UTSTART generic header into UT_DATE, RUTSTART, and DATE-OBS database headers.

to_UTEND

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.

from_UTEND

Converts the UTEND generic header into UT_DATE, RUTEND and DATE-END database headers.

to_X_BASE

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

from_X_BASE

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

to_RA_BASE

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

from_RA_BASE

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

INTERNAL METHODS

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::Piece object.

$time = _parse_date( $date );

Returns undef if the time could not be parsed. Returns the object unchanged if the argument is already a Time::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.

REVISION

$Id$

SEE ALSO

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

AUTHORS

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

COPYRIGHT

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