NAME

       Astro::FITS::Header::AST - Manipulates FITS headers from an AST object

SYNOPSIS

         use Astro::FITS::Header::AST;

         $header = new Astro::FITS::Header::AST( FrameSet => $wcsinfo );
         $header = new Astro::FITS::Header::AST( FrameSet => $wcsinfo,
                                                 Encoding => 'FITS-IRAF' );

         $header = new Astro::FITS::Header::AST( Cards => \@cards );

DESCRIPTION

       This module makes use of the Starlink::AST module to read the FITS HDU from an AST
       FrameSet object.

       It stores information about a FITS header block in an object. Takes an hash as an
       argument, with an array reference pointing to an Starlink::AST FramSet object.

REVISION

       $Id$

METHODS

       configure
           Reads a FITS header from a Starlink::AST FrameSet object

             $header->configure( FrameSet => $wcsinfo );

           Base class initialisation also works:

             $header->configure( Cards => \@cards );

           Accepts a reference to an Starlink::AST FrameSet object.

           If a specific encoding is required, this can be specified using the Encoding argument.
           Default is FITS-WCS if no Encoding is given.  Note that not all framesets can be
           encoded using FITS-WCS.

             $header->configure( FrameSet => $wcsinfo, Encoding => "Native" );

           If Encoding is specified but undefined, the default will be decided by AST.

SEE ALSO

       "Starlink::AST", "Astro::FITS::Header"

AUTHORS

       Alasdair Allan <aa@astro.ex.ac.uk>, Tim Jenness <t.jenness@jach.hawaii.edu>

COPYRIGHT

       Copyright (C) 2007-2011 Science and Technology Facilities Council.  Copyright (C)
       2001-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 3 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