ftag - manipulate/display the FLORET_TIFFTAG field of a floret TIFF
>& <log file>
-growth_protection
<retrys>
causes the system to retry an
sbrk(3)
call up to
retrys
times. This option permits the program to wait until the core that it requires
is available rather than simply exiting if
sbrk(3)
fails.
-usage
displays shortform usage string.
-version
displays program version number.
-slots
displays short form
pups(7)
library dependencies.
-slotinfo
displays long form
pups(7)
library dependencies.
-argf
argument_file
tells the filter to take its command line arguments from the specified
argument_file.
The data format of the argument file is:
# ... optional comment line ...
-argflag [1]
argument_parameter [1,1]
argument_parameter [1,2]
argument_parameter [1,n]
# ... optional comment line ...
-argflag [2]
argument_parameter [1,1]
argument_parameter [1,2]
argument_parameter [1,n]
-nice
cardinal
determimes the
niceness
at which the filter is scheduled. In keeping with all UNIX user processes, nice
must be a cardinal between 0 and 20. The default niceness for
ftag(1)
is 4.
-tiff_name
name
specifies the name of the TIFF image whose
FLORET_TIFFTAG
is to be displayed and/or modified. This option is mandatory, and must be specified.
-meta_action
tells
ftag(1)
to execute the
meta action
specified in the
auxilliary data field
of the image it has loaded. Typically this is to call a URL which will provide information
on image content, or to call a filter to process the image. If other data is in the auxilliary
data field, the meta action must be enclosed using % characters.
-display
tells
ftag(1)
to display the
TIFFTAG_FLORET
field. If parameters within the field are updated, the contents of the field are
displayed
after
update. Defaults to FALSE (no display, unless no update has been done in which case
TIFFTAG_FLORET
is always displayed).
-create
tells
ftag(1)
to create a
TIFFTAG_FLORET
field (which is populated with default values for the field parameters).
-fname
floret image name
sets the name by which this TIFF is known to the DAISY system. This is disticnt from
the file name. Defaults to
notset.
-fmask
floret mask name
sets the name of the
mask file
(used by the
floret(1)
dynamic manifold reduction optimiser) associated with the current image.
-format
image format
specifies the image format. This option is used to specify unusual image formats (e.g.
IEEE floating point images). For current variants of the DAISY system it should be set
to
standard
which is the default (and encodes for a 8 bit per pixel 1 or 3 plane integer image).
-ftype
image type
can take two values,
training
in which case the DAISY system treats the image as a
training set image
or
unknown
in which case the system interprets the image as an unknown and will process
it accordingly. Defaults to
unknown.
-fcreate
tells
ftag(1)
to make the creation time of the image (which is used in the computation of lifetimes)
the current time.
-fkey
floret image key
sets the key for the
floret(1)
classifier. The classifier will only process this image if its key matches the internal key
passed to the classifier either at initialisation or subsequently via its
PSRP
interface. Defaults to
all.
-fid
floret user (terminal) indentifier
is used to identify the user (and terminal) to which
DAISY
is to send data on the organism it indentifies. Defaults to the username of the user
who is running
ftag(1).
-fmatch
floret class identifier
specifies the organism class this image matches. This option is intended to facilitate
testing of the DAISY
vhtml(1)
application.
-ftag
floret computation state tag
specifies the sensitisation tag for the image. This tag is probed by DAISY processes in
order to see if a given image is to be processed by them. No default.
-fmexthresh
threshold
sets the training set classifier excitation threshold for referenced image to
threshold.
-ftiwin
count
sets the incorrect win count (used by the dynamic excitation thresholding algorithm) to
count.
-fmcn
threshold
sets the training set cluster order threshold for referenced image to
threshold.
-fciwin
ets the incorrect win count (used by the dynamic cluster order thresholding algorithm) to
count.
-fmsill
sets the training set cluster edge (sill) threshold for referenced image to
threshold.
-fsiwin
ets the incorrect win count (used by the dynamic sill thresholding algorithm) to
count.
-lifetime
image lifetime in seconds
specifies how long an image is allowed to remain in the file system before it is deleted.
Defaults to 1 hour (e.g image will be deleted if it is not processed within 1 hour of submission).