Help for LABEL
LABEL is a VICAR program, designed for both interactive and batch
use, which can be used to create, remove, list, and modify in
various ways the labels in a VICAR file. It is designed to replace
all old IBM VICARlabel processing programs (LABCAT, VLABEL etc.) and
add additional capabilities.
When LABEL is invoked on the command line, the mode of operation
is determined by the subcommand which is used. For help on the
subcommands and the general operation of LABEL, type TUTOR LABEL.
Written by: D. F. Stanfill 1984
Cognizant Programmer: R. G. Deen 1992
Latest revision: R. G. Deen 5-92
Added support for Property labels, and added host
types and fixed binary labels in LABEL-CREATE.
J. F. McNeill 12-21-91
BINARY header and prefixes handled in all cases.
Header and prefix sizes added to LABEL-LIST info.
R. G. Deen 2-91
Converted to Unix-compatible executive
J. F. McNeill 8-16-90
Addition of BINARY keyword for -CREATE
PARAMETERS:
INP
Input file name
OUT
Output file name
(Optional)
ITEMS
List of items to be
added
TASK
Task name of label item
INSTANCE
Instance or occurrence of named
task
PROPERTY
Property name of label item
TYPE
Add HISTORY or PROPERTY label
!
.SUBCMD CREATE
Create a system label for an
unlabeled file.
INP
Input file name
OUT
Output file name
NL
Number of lines in image
in input image
NS
Number of samples in image
NB
Number of bands in input image
NBB
Number of binary prefix bytes
per line
NLB
Number of binary header lines
FORMAT
Pixel format
ORG
File organization
BINARY
Image has binary label?
WINDOW
Window to be taken from input
(independent of NL & NS)
BANDS
Bands to be taken from input
(independent of NB)
COMMENT
Optional comment for label
HOST
Machine type of input file
INTFMT
Integer format of input file
(default given by HOST)
REALFMT
Real format of input file
(default given by HOST)
BHOST
Machine type of input binary
label (default to HOST)
BINTFMT
Integer format of input binary
label (default given by BHOST)
BREALFMT
Real format of input binary
label (default given by BHOST)
BLTYPE
Type of binary label
!
!.SUBCMD CONCAT
!CONCAT not yet available
!
.SUBCMD DELETE
Delete all or part of the
history or property labels
INP
Input file name
OUT
Output file name
(Optional)
KEYS
Keywords of items
to be deleted
(or /ALL)
TASKS
Task names of KEYS or
tasks to be deleted
INSTNCES
Instances of TASKS
PROPERTY
Property names of KEYS
or properties to be
deleted
ELEMENT
Starting element
number to delete
NELEMENT
Number of elements
to delete
TYPE
Delete HISTORY or PROPERTY
labels
!
.SUBCMD LIST
List out label information
INP
Input file name(s)
(up to 10)
EXTENT
Extent of listing to be done
(type help for valid values)
PACK
Specifies packing of items
on a line
!
.SUBCMD REMOVE
Remove the label from an image
INP
Input file name
OUT
Output file name
SIZE
VICAR size field
(sl,ss,nl,ns)
BANDS
Window to be taken from input
(independent of NB)
BLOCKING
Block the output image?
(BLOCK,NOBLOCK)
BINARY
Binary label, header or prefix before image?
(BINARY,NOBINHEAD,NOBINPREF,NOBINARY)
!
.SUBCMD REPLACE
Replace a list of items
INP
Input file name
OUT
Output file name
(Optional)
ITEMS
List of items to be
replaced
TASK
Task name of label item
INSTANCE
Instance or occurrence of named
task
PROPERTY
Property name of label item
TYPE
TYPE of label item
(SYSTEM, HISTORY, or PROPERTY)
!
.SUBCMD SWITCH
Switch history labels
INP
Input file names
(2 required)
OUT
Output file name
!
See Examples:
Cognizant Programmer: