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 theCOORDINATE_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
toyyyymmdd
. - 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 headerX_BASE
. - from_X_BASE
-
Converts the decimal degrees in the generic header
X_BASE
into decimal hours for the FITS headerRABASE
. - to_RA_BASE
-
Converts the decimal hours in the FITS header
RABASE
into decimal degrees for the generic headerRA_BASE
. - from_RA_BASE
-
Converts the decimal degrees in the generic header
RA_BASE
into decimal hours for the FITS headerRABASE
. - 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
1 POD Error
The following errors were encountered while parsing the POD:
- Around line 119:
You forgot a '=back' before '=head1'