get_card


This routine reads a keyword of any kind from a FITS header. It is a wrapper to other routines that read keywords of different kinds.

Location in HEALPix directory tree: src/f90/mod/head_fits.F90 


FORMAT

call get_card( header, kwd, value, comment )


ARGUMENTS

name & dimensionality kind in/out description
       
header(LEN=80) DIMENSION(:) CHR IN The header to read the keyword from.
kwd(LEN=8) CHR IN the FITS keyword to read (NOT case sensitive).
value any OUT the value read for the keyword. The type of the fortran variable 'value' (double, real, integer, logical or character) should match the type under which the value is written in the FITS file, except if 'value' is a character string, in which case it can read any keyword value, or if 'value' if real or double, in which case it can read any numerical value. Note that long string values (more than 68 characters in length) are supported.
comment(LEN=*) CHR OUT comment read for the keyword.


EXAMPLE:

call get_card(header,'NsIdE',nside,comment)
if nside is defined as an integer, it will contain on output the value of NSIDE (say 256) found in header


EXAMPLE:

call get_card(header,'ORDERING',ordering,comment)
if ordering is defined as an character string, it will contain on output the value of ORDERING (say 'RING') found in header


MODULES & ROUTINES

This section lists the modules and routines used by get_card.

cfitsio
library for FITS file handling.


RELATED ROUTINES

This section lists the routines related to get_card

add_card
general purpose routine to write any keywords into a FITS file header
del_card
routine to discard a keyword from a FITS header
read_par, number_of_alms
routines to read specific keywords from a header in a FITS file.
getsize_fits
function returning the size of the data set in a fits file and reading some other useful FITS keywords
merge_headers
routine to merge two FITS headers

Version 3.31, 2017-01-06