- ←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 name may be
compound to permit writing of hierarchical keywords.
Invocation
CALL FTS1_WKEYx(
NAME, VALUE, CMTBGN, COMNT, 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 = ? (Given)
The value of the keyword.
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.
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.
HEADER = CHARACTER
( 80 )
(Returned)
The created FITS-header card.
STATUS = INTEGER (Given and Returned)
The global
status.
Notes:
-
There is a routine for each of the data types logical, integer, 64-bit integer, real, and double precision:
replace " x" in the routine name by L, I, K, R or D as appropriate.
-
The comments are written from column 32 or higher if the value demands more than the customary 20
characters for the value. A comment may be omitted if the value is so long to leave no room.
- ←Prev
- KAPLIBS – Internal subroutines used within the KAPPA package.
- Next→
- TOC ↑