VisionX V4V3GENGRIDVisionX V4
NAME

v3gengrid - construct 3d regular grid points and tessellation (.pts and .grid files)

SYNOPSIS

v3gengrid [-H] [gf=<inputfile2>] [pf=<value>] [xl=<value>] [xh=<value>] [yl=<value>] [yh=<value>] [zl=<value>] [zh=<value>] [dx=<value>] [dy=<value>] [dz=<value>] [r=<value>] [-v] [-s] [px=<value>] [py=<value>] [pz=<value>]

DESCRIPTION

v3gengrid constructs a regular grid of 3d points and its tessellation. The points are spaced according to the xl, xh, yl, yh, zl, zh, dx, dy, and dz parameters. The default grid is composed of cubes, however the -s option can be used to create a shifted cubic grid.

Any combination of output files can be specified. The .grid file is a VX file with 2 objects. Object 1 is a list of grid points, stored in length-3 VX_V3D vectors, while Object 2 is a list of tetrahedra, stored as a list of length-4 VX_V2D vectors, with each element referring to a vertex. The .pts file is a list of feature points and warped points, stored in length-6 VX_V3D vectors. Each length-6 vector contains the feature points followed by the warped point. The default .pts file sets the feature and warped points to the grid points. The r= option computes a random set of warped points, and can be used for testing the warping algorithm.

OPTIONS

gf=

output file : .grid file with points/tets

pf=

outputfile : .pts file with point mappings

xl=

xlo (default = 0)

xh=

xhi (default = 100)

yl=

ylo (default = 0)

yh=

yhi (default = 100)

zl=

zlo (default = 0)

zh=

zhi (default = 100)

dx=

dx (default = 20)

dy=

dy (default = 20)

dz=

dz (default = 20)

r=

compute random warping with deviation r

-v

verbose option

-s

use shifted grid to make better tetrahedrons

CONSTRAINTS

*

doesn’t like when dx, dy, or dz is zero

BUGS

--

SEE ALSO

v3warp, v3vgrid

AUTHOR

A. B. Chan, M.Eng. Project 2000-01