RETRO (vipl) functions
LIBRARY ROUTINE
lvmindis - Minimum Distance Classifier
LIBRARY CALL
int lvmindis (
xvimage *img,
xvimage *center,
int border)
INPUT
- img - the input image that is to be classified.
- center - the image containing the center values (or
prototype vectors) with the last data band
being the class image.
- border - the border width on the image. The border
corresponds to a no class assignment.
OUTPUT
- img - a single band classified image.
RETURN VALUE
TRUE (1) on success, FALSE (0) on failure
DESCRIPTION
vmindis is a simple minimum distance classifier.
The distance metric used to the Euclidean distance.
This routine accpets two images as the input. The
image that corresponds to the variable image is the
image that needs to be classified. This image can
be have as many data bands as necessary. The number
of data bands depicts the dimensionality of the
vectors. Each pixel in the image is a vector with
dimensionality of the number of data bands.
The other input image which corresponds to the
variable center is the prototype image. The last
data band of this image is the class data band.
This image must contain the same number of data
bands as the other input image plus an extra data
band that represents the class mapping. This
image would most likely have been created by
vkmeans or some other routine that will give
cluster centers. This image contains vectors that
correspond to the prototype of each class.
As stated above the center image's last data band
is a class data band. The class data band simply
maps each vector in the center image to the final
class.
The border variable allows the user to specify a
border width, in pixels, encompassing the image.
The border region is skipped by vmindis when
classification is performed. This usefull if
neighborhood operators have been used previously
and have not updated edge pixels.
All input images must be of data storage type FLOAT.
ADDITIONAL INFORMATION
none
EXAMPLES
none
SIDE EFFECTS
none
RESTRICTIONS
All input images must be of data storage type FLOAT.
MODIFICATION
none
FILES
$RETRO/objects/library/vipl/src/lvmindis.c
SEE ALSO
vipl(3)
COPYRIGHT
Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.