USGS

Isis 2 Documentation


picslabels Documentation

picslabels - Lists or modifies image labels
PROGRAMMER: TSTOEWE
Handles image disk labels, which contain the home block, histogram area,
keyword label area and the processing history text area. The homeblock
area contains information about the image such as image size, bit type
and pointers to the other label areas. The histogram area contains a
histogram of the image. The keyword label area contains information
needed to process the image.  Keywords are in the form,
'keyword=keyvalue'.  An example,
                     TARGET=MIRANDA.
The processing history text area contains a list of the processing which
has been done on the image and some parameters.  LABELS allows you to
print these label areas, add information to the keyword or processing
history text area, initialize the histogram, keyword or processing
history text area, or delete a keyword from the keyword label area.
See the PICS manual appendix for more information about the image
labels.

ParmDescriptionDefault
FROM
INPUT DISK FILE NAME
NONE
PRINT
PRINT LABELS
NONE
UPDATE
ADD INFORMATION TO LABELS
NONE
INIT
INITIALIZE LABELS
NONE
MAX
MAXIMUM LENGTH ALLOWED FOR
LABEL KEYVALUES TO BE PRINTED
80
KEYWORD
KEYWORD THAT IS TO BE ADDED
OR UPDATED
""
KEYVALUE
VALUE OF THE KEYWORD THAT IS
TO BE ADDED OR UPDATED
""
DELETE
KEYWORD THAT IS TO BE DELETED
""
TEXT
ADDITION TO PROCESSING HISTORY
TEXT
""

ADDITIONAL NOTES:

ParmDescription
PRINT
Indicates which label areas to print.  Possible values are
NONE,ALL,HIST,KEY,HOME or TEXT.  A parm value of TEXT in
this and succeeding parameters refers to processing history
text.
UPDATE
This option will add text to the end of any existing
processing text or will update the keyword label area.
Possible values are NONE,KEY and TEXT.
MAPPING keywords can not be updated.
INIT
Eliminates label information which is currently in specified
label area.  This will not initialize the home block.
Possible values are NONE,ALL,HIST,KEY or TEXT.
KEYWORD
This contains the keyword that is to be added or updated in
the keyword label area.  Note:  MAPPING keywords can not be
updated.
KEYVALUE
This contains the keyvalue that goes along with the keyword
that is to be added or updated in the keyword label area.
Ex:  KEYWORD=TARGET, KEYVALUE=MIMAS will change the target
to MIMAS.
DELETE
This contains the keyword that is to be deleted from the
keyword label area.
TEXT
This contains the text that will be appended to the
processing history text area.
MAX
If the length of the value of a labels keyword is greater
than this maximum, the keyword will be printed without the
value. This is to suppress the printing of RESEAUS.

Last updated: Jan 31 2005
File: pdfs3.html

Contact us online at the Isis Support Center: http://isisdist.wr.usgs.gov

ISIS Documentation Home Page