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

Package: nttools

Usage

tabkey table column row output keyword

Description

This task copies the value of a table element to a header keyword in either a table or an image. If the table element and the header keyword are of different data types, this task will convert the type. An error will occur if any attempt is made to copy an undefined table element to a header keyword. If the value of the task parameter 'add' is "yes", the task will allow you to add a new keyword to the header, otherwise, adding a new keyword will cause an error.

Parameters

table [file name]: Name of table containing the element to be copied. The particular element is defined by the 'column' and 'row' parameters.

column [string]: Name of column. (Column names are not case sensitive.)

row [integer, min=1, max=INDEF]: Row number.

output [file name]: Name of the file with the header keyword whose value is to be changed.

keyword [string]: Name of header keyword. (Header keyword names are not case sensitive.)

(add = no) [boolean]: Allow new keywords to be added to the header? If 'add = no', then only existing header keywords can be modified--an error will occur if a keyword is specified that does not already exist.

Examples

1. Copy the first component name (i.e., row 1 of column 'COMPNAME' from the file 'graph.tab' to the header of the table 'thruput.tab'. If the keyword does not already exist, then add it:

tt> tabkey graph.tab COMPNAME 1 thruput.tab COMPNAME add+

2. Copy the date of the tenth observation (i.e., row 10 of column 'DATE') from the file 'schedule.tab' to the header keyword 'DATE' in 'image.hhh'. The keyword 'DATE' must already exist:

tt> tabkey schedule.tab DATE 10 image.hhh date

Bugs

References

This task was written by Bernie Simon.