Astro::FITS::HdrTrans module
----------------------------

What is it?
-----------
Astro::FITS::HdrTrans and associated sub-classes are tools for translating
instrument-specific FITS headers into generically named headers.

Requirements
------------
The Astro::FITS::HdrTrans module has minimal requirements on other
modules; only Carp and Time::Piece are required. Instrument-specific
sub-classes of Astro::FITS::HdrTrans may require other modules to be
installed, depending on the transformations those sub-classes make.
As an example, the translation sub-class for IRIS2 (an imaging
spectrometer used at the Anglo-Australian Telescope) requires
Math::Trig in order to do zenith distance to airmass translations.

Adding Subclasses
-----------------
Adding subclasses to do translations for other instruments should
be fairly straight-forward. Detailed documentation can be found
in the Astro::FITS::HdrTrans::Base class.

Where can I get it?
-------------------
The package is available from CPAN <http://www.cpan.org/>.

Installation
------------
Installation is automated using the ExtUtils::MakeMaker library

    % perl Build.PL
    % ./Build
    % ./Build test
    % ./Build install

Authors
-------

The module was written by Brad Cavanagh <b.cavanagh@jach.hawaii.edu> and
Tim Jenness <t.jenness@jach.hawaii.edu> of the Joint Astronomy Centre
(JAC) in Hawaii.

Copyright (C) 2007-2012 Science and Technologh 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

Maintainer
----------
The package is currently maintained by Tim Jenness <tjenness@cpan.org>.
Please use CPAN RT for bug reports and github pull requests for patches.
The source code repository is at

  git://github.com/timj/perl-Astro-FITS-HdrTrans.git

Changes
-------

 v0.01 - initial test release to CPAN

 v0.02 - Change licence in README to be same as Perl.
         Add copyright statement.
         Add requirement on Test::More and Time::Piece to Makefile.PL.

 v0.03 - Licence should have been GPL

 v0.05 - Major rewrite of internals.
         Supports all UKIRT and JCMT instruments

 v1.50 - Includes support for SCUBA-2 and many fixes for ACSIS.

 v1.51 - Use Module::Build
       - Minor fix for polarimeter recipe in ACSIS

 v1.52 - Add LCOG instruments (thanks to Tim Lister)
       - Added OBSERVATION_ID_SUBSYSTEM
       - Many improvements to JCMT translations.
       - Astro::SLA is now only required for NIRI translations.

 v1.53 - The ACSIS test should skip if Starlink::AST is missing.

 v1.54 - Update SCUBA-2 base coordinates estimate so that it can
         work with subheaders and missing start azel position.
