keytab: Copy an image or table header keyword to a table element.

Package: nttools

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.