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