NAME

keytab -- Copy a header keyword to a table element.

USAGE

keytab input keyword table column row

DESCRIPTION

This task reads a header keyword from either an image or a table file and writes it to a table element (row and column position). If the data type of the header keyword differs from that of the table element, then the value is converted to the appropriate data type. If the keyword is not found in the header, the element will be set to the null value appropriate for the column type.

PARAMETERS

input [file name]

Name of the file containing header keyword.

keyword [string]

Name of the header keyword to be read. (Keyword names are not case sensitive.)

table [file name]

Name of the table to which the value will be written.

column [string]

Name of table column. (Column names are not case sensitive.)

row [integer, min=1, max=INDEF]

Table row number.

(silent = no) [bool]

If this parameter is set to no (the default) a warning message will be printed if the keyword is not found in the header. If it is set to yes, the warning message is suppressed.

EXAMPLES

1. Copy the component name (i.e., the COMPNAME header keyword) from the table thruput.tab to the first row of the table graph.tab.

tt> keytab thruput.tab COMPNAME graph.tab COMPNAME 1

2. Copy the zero point of the second group (i.e., the CRVAL1 keyword) in the image file image.hhh to the first wavelength in the table spectrum.tab.

tt> keytab image.hhh[2] CRVAL1 spectrum.tab WAVELENGTH 1

REFERENCES

This task was written by Bernie Simon.

SEE ALSO

keypar, parkey, partab, tabkey, tabpar