Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

astro::fits::header::cfitsio(3pm) [debian man page]

Astro::FITS::Header::CFITSIO(3pm)			User Contributed Perl Documentation			 Astro::FITS::Header::CFITSIO(3pm)

NAME

       Astro::FITS::Header::CFITSIO - Manipulates FITS headers from a FITS file

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 CFITSIO module to read and write directly to a FITS HDU.

       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) and FITS identifier.

REVISION

       $Id$

METHODS

       configure
	   Reads a FITS header from a FITS HDU

	     $header->configure( Cards => @cards );
	     $header->configure( fitsID => $ifits );
	     $header->configure( File => $file );
	     $header->configure( File => $file, ReadOnly => $bool );

	   Accepts an FITS identifier or a filename. If both fitsID and File keys exist, fitsID key takes priority.

	   If "File" is specified, the file is normally opened in ReadWrite mode.  The "ReadOnly" argument takes a boolean value which determines
	   whether the file is opened ReadOnly.

       writehdr
	   Write a FITS header to a FITS file

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

	   Its accepts a FITS 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 "cfitsio" subroutine library (v2.1 or greater).

SEE ALSO

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

AUTHORS

       Alasdair Allan <aa@astro.ex.ac.uk>, Jim Lewis <jrl@ast.cam.ac.uk>, 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 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

perl v5.14.2							    2012-06-30					 Astro::FITS::Header::CFITSIO(3pm)

Check Out this Related Man Page

fitstopnm(1)                                                  General Commands Manual                                                 fitstopnm(1)

NAME

       fitstopnm - convert a FITS file into a portable anymap

SYNOPSIS

       fitstopnm [-image N] [-noraw] [-scanmax] [-printmax] [-min f] [-max f] [FITSfile]

DESCRIPTION

       Reads  a FITS file as input.  Produces a portable pixmap if the FITS file consists of 3 image planes (NAXIS = 3 and NAXIS3 = 3), a portable
       graymap if the FITS file consists of 2 image planes (NAXIS = 2), or whenever the -image flag is specified.  The  results  may  need  to  be
       flipped top for bottom; if so, just pipe the output through pnmflip -tb.

OPTIONS

       The  -image  option  is for FITS files with three axes.  The assumption is that the third axis is for multiple images, and this option lets
       you select which one you want.

       Flags -min and -max can be used to override the min and max values as read from the FITS header or the image data if no DATAMIN and DATAMAX
       keywords are found.  Flag -scanmax can be used to force the program to scan the data even when DATAMIN and DATAMAX are found in the header.
       If -printmax is specified, the program will just print the min and max values and quit.  Flag -noraw can be used to force  the  program  to
       produce an ASCII portable anymap.

       The program will tell what kind of anymap is writing.  All flags can be abbreviated to their shortest unique prefix.

REFERENCES

       FITS  stands for Flexible Image Transport System.  A full description can be found in Astronomy & Astrophysics Supplement Series 44 (1981),
       page 363.

SEE ALSO

       pnmtofits(1), pgm(5), pnmflip(1)

AUTHOR

       Copyright (C) 1989 by Jef Poskanzer, with modifications  by  Daniel  Briggs  (dbriggs@nrao.edu)  and  Alberto  Accomazzi  (alberto@cfa.har-
       vard.edu).

                                                                  20 September 89                                                     fitstopnm(1)
Man Page