NAME

       Astro::FITS::Header::GSD - Manipulate FITS headers from GSD files

SYNOPSIS

         use Astro::FITS::Header::GSD;

         $hdr = new Astro::FITS::Header::GSD( Cards => \@cards );
         $hdr = new Astro::FITS::Header::GSD( gsdobj => $gsd );
         $hdr = new Astro::FITS::Header::GSD( File => $file );

DESCRIPTION

       This module makes use of the Starlink GSD module to read from a GSD header.

       It stores information about a FITS header block in an object. Takes an hash as an
       argument, with either an array reference pointing to an array of FITS header cards, or a
       filename, or (alternatively) a GSD object.

METHODS

       configure
           Reads a header from a GSD file.

             $hdr->configure( Cards => \@cards );
             $hdr->configure( Items => \@items );
             $hdr->configure( gsdobj => $gsd );
             $hdr->configure( File => $filename );

           Accepts a GSD object or a filename. If both "gsdobj" and "File" keys exist, "gsdobj"
           key takes priority.

       writehdr
           The GSD library is read-only. The writehdr method is not implemented for this sub-
           class.

NOTES

       This module requires the Starlink GSD module.

       GSD supports keys that are longer than the 8 characters allowed as part of the FITS
       standard. GSD keys are truncated to 8 characters by this module.

SEE ALSO

       NDF, Astro::FITS::Header, Astro::FITS::Header::Item Astro::FITS::Header::CFITSIO,
       Astro::FITS::Header::NDF

AUTHORS

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

COPYRIGHT

       Copyright (C) 2008-2011 Science & Technology Facilities Council.  Copyright (C) 2001-2002
       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