ISIS Application Documentation
Outputs the value of a requested keyword
Description
Categories
Groups
History
Description
This program will output the value of a requested keyword.
Its general use is
within batch jobs, perl programs, or other scripting languages. It allows
the script writer to easily obtain values from cube labels or other
label-like files such as those output by programs like stats, percent, etc.
Categories
Parameter Groups
Files
|
Name
|
Description
|
| FROM |
Filename of a label file
|
Selection
|
Name
|
Description
|
| OBJNAME |
Object name containing the group or keyword
|
| GRPNAME |
Group name containing the keyword
|
| KEYWORD |
Keyword name
|
| KEYINDEX |
Index in keyword to return
|
Options
|
Name
|
Description
|
| UPPER |
Convert results to uppercase
|
| RECURSIVE |
Recursively searches for keyword
|
Files:
FROM
Description
The file specification containing the input label.
|
Type
| filename |
|
File Mode
| input |
|
Filter
|
*.cub
|
Selection:
OBJNAME
Description
Enter the name of the Object which contains the group or keyword.
If the keyword is not in an Object then ignore this parameter.
The name is case insensitive.
|
Type
| string |
|
Internal Default
| Root |
Selection:
GRPNAME
Description
Enter the name of the Group which contains the keyword.
|
Type
| string |
|
Internal Default
| Root |
Selection:
KEYWORD
Description
Enter the name of the keyword.
Selection:
KEYINDEX
Description
If the keyword is a list, you may enter an integer value for the index of the keyword
value you would like to retrieve. The default is 'All' and will return the entire list of
keyword values.
|
Type
| integer |
|
Internal Default
| All |
|
Minimum
| 1
(inclusive)
|
Options:
UPPER
Description
If set this parameter causes all character output to be
in uppercase.
|
Type
| boolean |
|
Default
| False |
Options:
RECURSIVE
Description
If set it will search recursively, however if an object name is specified it will recursively
search for that object and then recursively search inside only that object.
|
Type
| boolean |
|
Default
| False |
History
| Jeff Anderson | 2002-10-25 |
Original version
|
| Kim Sides | 2003-05-13 |
Added application test
|
| Stuart Sides | 2003-05-16 |
Modified schema location from astogeology... to isis.astrogeology..."
|
| Jeff Anderson | 2004-03-29 |
Change parameter from GROUP to GRPNAME because of conflicts in the
print and history files (keyword named GROUP in a GROUP). Added
OBJNAME and UPPER parameters.
|
| Brendan George | 2005-11-03 |
Fixed application test
|
| Elizabeth Miller | 2006-05-09 |
Added KEYINDEX param and fixed bug with list keywords. Also modified
to output to the UI session log rather than the terminal window if the UI is
open.
|
| Elizabeth Miller | 2006-06-14 |
Fixed bug that did not allow you to get a keyword that was not in a group
or object and reworked code to avoid the repetition of code
|
| Elizabeth Miller | 2006-07-24 |
Added helper button to the FROM parameter to output the file.
|
| Steven Koechle | 2007-08-14 |
Added recursive search option
|
| Steven Koechle | 2008-03-05 |
Changed preferences to not output to terminal, and added results
group to session log.
|
| Christopher Austin | 2010-03-03 |
Made UPPER equal to FALSE by default
|
| Steven Lambright | 2012-12-27 |
Fixed bug caused by #1312. The array output gained parenthesis on accident,
these have been removed. A new test was added to ensure that this doesn't
happen again. Fixes #1360.
|
| Ra'ad Saleh | 2013-02-04 |
Fixed error in printing PVL values caused by line continuations. Fixes #1017.
|