lvmindis(3)

LIBRARY ROUTINE
lvmindis - Minimum Distance Classifier

LIBRARY CALL
#include "vinclude.h"
lvmindis (img, center, border)
struct xvimage *img,            /* input image */
               *center;         /* cluster center image */
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.

MODIFICATIONS

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.

img - struct xvimage
    the input image that is to be classified.

center - struct xvimage
    the image containing the center values (or prototype vectors) with the last data band being the class image.

border - int
    the border width on the image. The border corresponds to a no class assignment.

lvmindis will return a 1 upon sucess and a 0 upon failure.

SEE ALSO
vmindis(1), intro(3), vipl(3), verror(3), vutils(3)

RESTRICTIONS
All input images must be of data storage type FLOAT.

AUTHOR
Tom Sauer

COPYRIGHT
Copyright 1991, University of New Mexico. All rights reserved.