vclose(1)

PROGRAM
vclose - Close boundaries in images

SYNTAX

vclose

-i1 Input Boundary Image (resulting from vdrf, vgef, vsdef ...)

-i2 Input Gradient Image (resulting from vdrf, vsdef, sobel...)

-o  resulting output image or file

[-grad]
    Gradient Threshold (used by the closing process)

[-len]
    Minimum Gap Size In Pixels

[-V]
    Gives the version for vclose

[-U]
    Gives the usage for vclose

[-P]
    Prompts for command line options

[-A [file1]]
    Creates the answer file called vclose.ans or file1

[-a [file1]]
    Uses vclose.ans or file1 as the answer file

DESCRIPTION
vclose uses a boundary image and a gradient image as input. Then it tries to close the boundaries by following the maximum gradient between two end points of two contours.

The new closing part is kept if its length is at least "Minimum_Gap_Size" pixels. This parameter is used to prevent the result from being covered by small contours (edges of noisy areas...).

The minimum gradient value "Gradient_Threshold" has to be set up to indicate to the closing process up to what value it can follow a maximum gradient curve to close a boundary.

This Algorithm has been writen by:

    Professor SERGE CASTAN, Prof CHEN and Dr ZHAO

    IRIT, CNRS, URA 1399

    118, route de Narbonne 31062 Toulouse FRANCE

REQUIRED ARGUMENTS

-i1 type: infile
    desc: Input Boundary Image (resulting from vdrf, vgef, vsdef ...)

-i2 type: infile
    desc: Input Gradient Image (resulting from vdrf, vsdef, sobel...)

-o  type: outfile
    desc: resulting output image or file

OPTIONAL ARGUMENTS

-grad
    type: integer
    desc: Gradient Threshold (used by the closing process)
    default: 0
    bounds: value >= 0

-len
    type: integer
    desc: Minimum Gap Size In Pixels
    default: 1
    bounds: value >= 0

EXAMPLES
vclose -i1 feath_edge.xv -i2 feath_grad.xv -v 5 -f 0.5 -o closed_boundary.xv

Will use feath_edge.xv and feath_grad.xv as the edges and respectively the gradient representation of an image. Then it will close the unclosed boundaries using a minimum gap size of 5 pixels and a gradient threshold of 0.5 .SH SEE ALSO intro(1), verror(3), vgparms(3), vutils(3), lvclose(3)

RESTRICTIONS
vclose will only work with single band images. Then the first image has to be of data storage type VFF_TYP_1_BYTE. The second input can be anything from VFF_TYP_1_BYTE to VFF_TYP_FLOAT.

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