vmorph − 2D and 3D morphological filter

vmorph [-H] [if=<inputfile>] [of=<outputfile>] [k=<file>] [s=x[,y[,z]]] [t=<s | c>] [-de] [-ed] [-d] [-e] [-f] [-c] [-v]

Vmorph performs a binary morphological filter, using either a specified kernel or one that is automatically generated according to specification. The following morphological operations are supported: erosion, dilation, opening (erosion followed by dilation), and closing (dilation followed by erosion). Automatically-generated kernels include spheres, ellipsoids, rectangular parallelpipeds, as well as 2D ellipses and rectangles.

Different algorithms are implemented in this program. The program uses the ratio of foreground to background voxels information to select the fastest algorithm if the [-f] option is not selected.

if=<input file>

specifies a VisionX unsigned byte (VX_PBYTE) input file.

of=<output file>

specifies the output file.

k=<file>

specifies the optional kernel file for morphological filtering.

s=<x[,y[,z]]>

specifies the dimensions of the kernel to be generated. The kernel type (see below) determines whether the kernel is ellipsoidal or rectangular. Given this constraint, the s parameter behaves as follows: if one value is given, it specifies the diameter of a sphere or cube. Two values specify an ellipse/circle or rectangle/square. Three values specify an arbitrary ellipsoid or rectangular parallelpiped. The default kernel is a sphere of diameter 1.0.

Hint: To select the 4(/6) near neighbors specify t=s and s=2.5. Also, even values for the s parameters provide even kernel sizes that are offset to the pixel location.

t=<type>

specifies the kernel type to be generated, where ’s’ corresponds to a spherical/ellipsoidal kernel and ’c’ to a cubic/rectangular kernel (default is spherical/ellipsoidal).

-de

perform morphological closing (dilation-erosion).

-ed

perform morphological opening (erosion-dilation).

-d

perform morphological dilation.

-e

perform morphological erosion.

-c

cancel auto-centering of the kernel.

-f

do not use the fast implementation

-v

verbose operation. Prints some runtime information.

vsf(1), vgen3d(1), v3morph(1), v3morphx(1)

W. J. Kostis, Andinet A. Enquobahrie and A. P. Reeves