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 <[email protected]> and
Tim Jenness <[email protected]> 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 <[email protected]>.
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.