add_card

This routine writes a keyword of any kind into a FITS header. It is a wrapper to other routines that write keywords of different kinds.

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

FORMAT

call add_card( header, kwd, value[, comment, update] )

Arguments appearing in italic are optional.

ARGUMENTS

name & dimensionality	kind	in/out	description
header(LEN=80) DIMENSION(:)	CHR	INOUT	The header to write the keyword to.
kwd(LEN=*)	CHR	IN	the FITS keyword to write. Should be shorter or equal to 8 characters.
value	any	IN	the value (double, real, integer, logical or character string) to give to the keyword. Note that long string values (more than 68 characters in length) are supported.
comment(LEN=*)	CHR	IN	comment to the keyword.

update

LGT

IN

if set to .true., the first occurence of the keyword kwd in header will be updated (and all other occurences removed); otherwise, the keyword will be appended at the end (and any previous occurence removed). If the keyword is either 'HISTORY' or 'COMMENT', update is ignored and the keyword is peacefully appended at the end of the header.

EXAMPLE:

character(len=80), dimension(1:120) :: header
header = ” ! very important
call add_card(header,'NSIDE',256,'the nside of the map')

Gives the keyword `NSIDE' the value 256 in the given header-string. It is important to make sure that the header string array is empty before attempting to write anything in it.

MODULES & ROUTINES

This section lists the modules and routines used by add_card.

write_hl

more general routine for adding a keyword to a header.

cfitsio

library for FITS file handling.

RELATED ROUTINES

This section lists the routines related to add_card

write_minimal_header

routine to write HEALPix compliant baseline FITS header

get_card

general purpose routine to read any keywords from a header in a FITS file.

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