NAME

Astro::FITS::HdrTrans::IRIS2 - IRIS-2 Header 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 AAO IRIS2 FITS headers to and from generic headers. See Astro::FITS::HdrTrans for a list of generic headers.

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 "UFTI".

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_AIRMASS_START

Converts FITS header value of zenith distance into airmass value.

from_AIRMASS_START

Converts airmass into zenith distance.

to_AIRMASS_END

Converts FITS header value of zenith distance into airmass value.

from_AIRMASS_END

Converts airmass into zenith distance.

to_COORDINATE_TYPE

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

to_UTDATE

Converts FITS header values into standard UT date value of the form YYYY-MM-DD.

from_UTDATE

Converts UT date in the form yyyy-mm-dd to yyyymmdd.

to_OBSERVATION_MODE

Determines the observation mode from the IR2_SLIT FITS header value. If this value is equal to "OPEN1", then the observation mode is imaging. Otherwise, the observation mode is spectroscopy.

to_UTSTART

Converts FITS header UT date/time values for the start of the observation into an ISO 8601 formatted date.

from_UTSTART

Converts an ISO 8601 formatted date into two FITS headers for IRIS2: IDATE (in the format YYYYMMDD) and RUTSTART (decimal hours).

to_UTEND

Converts FITS header UT date/time values for the end of the observation into an ISO 8601-formatted date.

from_UTEND

Converts an ISO 8601 formatted date into two FITS headers for IRIS2: IDATE (in the format YYYYMMDD) and RUTEND (decimal hours).

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.

to_ROTATION

Converts a linear transformation matrix into a single rotation angle. This angle is measured counter-clockwise from the positive x-axis.

to_Y_SCALE

Converts a linear transformation matrix into a pixel scale in the declination axis. Results are in arcseconds per pixel.

to_X_SCALE

Converts a linear transformation matrix into a pixel scale in the right ascension axis. Results are in arcseconds per pixel.

REVISION

 $Id: IRIS2.pm,v 1.12 2005/04/06 03:42:09 timj Exp $

SEE ALSO

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

AUTHOR

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

COPYRIGHT

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