- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑
Description:
This routine writes a FITS-header card using the supplied keyword, value, comment, and comment
delimiter. The card is either a character string value, or a comment card. The latter occurs when
the keyword is blank, HISTORY or COMMENT, or the COMCAR argument is .TRUE.; in
this case both the supplied value and comment delimiter are ignored. The name may be
compound to permit writing of hierarchical keywords.
Invocation
CALL FTS1_WKEYC( NAME,
VALUE, CMTBGN, COMNT, COMCAR, HEADER, STATUS )
Arguments
NAME = CHARACTER
(
) (Given)
The name of the keyword to be written. This may be a compound name to handle hierarchical keywords,
and it has the form keyword1.keyword2.keyword3 etc. The maximum number of keywords per FITS
card is 20. The value is converted to uppercase and blanks are removed before being used. Each
keyword must be no longer than 8 characters. The total length must not exceed 48 characters. This is
to allow for the value, and indentation into a blank-keyword card (as hierarchical keywords are not
standard and so cannot be part of the standard keyword name).
VALUE = CHARACTER
(
)
(Given)
The value of the keyword. It is ignored when the keyword is COMMENT,
HISTORY, or blank, or COMCAR = .TRUE..
CMTBGN = CHARACTER
( 1 ) (Given)
The character which indicates the beginning of the comment string of to be appended to the keyword.
Normally it is ’ /’ . when it is blank, no comment will be appended to the keyword. It is ignored when
the keyword is COMMENT, HISTORY, or blank, or COMCAR = .TRUE..
COMNT = CHARACTER
(
)
(Returned)
The comment string of the keyword. It may be truncated at the end to put into the space
left after writing keyword value for non-commentary keywords.
COMCAR = LOGICAL (Given)
If
.TRUE., the supplied card is a comment and thus the value and comment delimiter are ignored, and just
the keyword and comment string are used to generate the header card.
HEADER = CHARACTER
( 80 )
(Returned)
The created FITS-header card.
STATUS = INTEGER (Given and Returned)
The global
status.
- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑