SYNOPSIS

  use Astro::FITS::Header::CFITSIO;

  $header = new Astro::FITS::Header::CFITSIO( Cards => \@array );
  $header = new Astro::FITS::Header::CFITSIO( File => $file );
  $header = new Astro::FITS::Header::CFITSIO( fitsID => $ifits );

  $header->writehdr( File => $file );
  $header->writehdr( fitsID => $ifits );

DESCRIPTION

This module makes use of the \s-1CFITSIO\s0 module to read and write directly to a \s-1FITS\s0 \s-1HDU\s0.

It stores information about a \s-1FITS\s0 header block in an object. Takes an hash as an argument, with either an array reference pointing to an array of \s-1FITS\s0 header cards, or a filename, or (alternatively) and \s-1FITS\s0 identifier.

REVISION

$Id$

METHODS

configure

Reads a \s-1FITS\s0 header from a \s-1FITS\s0 \s-1HDU\s0 $header->configure( Cards => \@cards ); $header->configure( fitsID => $ifits ); $header->configure( File => $file ); $header->configure( File => $file, ReadOnly => $bool ); Accepts an \s-1FITS\s0 identifier or a filename. If both fitsID and File keys exist, fitsID key takes priority. If \*(C`File\*(C' is specified, the file is normally opened in ReadWrite mode. The \*(C`ReadOnly\*(C' argument takes a boolean value which determines whether the file is opened ReadOnly.

writehdr

Write a \s-1FITS\s0 header to a \s-1FITS\s0 file $header->writehdr( File => $file ); $header->writehdr( fitsID => $ifits ); Its accepts a \s-1FITS\s0 identifier or a filename. If both fitsID and File keys exist, fitsID key takes priority. Returns undef on error, true if the header was written successfully.

NOTES

This module requires Pete Ratzlaff's Astro::FITS::CFITSIO module, and William Pence's \*(C`cfitsio\*(C' subroutine library (v2.1 or greater).

RELATED TO Astro::FITS::Header::CFITSIO…

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

AUTHORS

Alasdair Allan <[email protected]>, Jim Lewis <[email protected]>, Diab Jerius.

COPYRIGHT

Copyright (C) 2007-2009 Science & Technology Facilities Council. Copyright (C) 2001-2006 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 \s-1GNU\s0 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 \s-1WITHOUT\s0 \s-1ANY\s0 \s-1WARRANTY\s0; without even the implied warranty of \s-1MERCHANTABILITY\s0 or \s-1FITNESS\s0 \s-1FOR\s0 A \s-1PARTICULAR\s0 \s-1PURPOSE\s0. See the \s-1GNU\s0 General Public License for more details.

You should have received a copy of the \s-1GNU\s0 General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place,Suite 330, Boston, \s-1MA\s0 02111-1307, \s-1USA\s0