v3ps − compute statistics of a 3D VisionX image file

v3ps [-H] [if=<inputfile>] [of=<outputfile>] [vs=<value>] [vz=<value>] [-vol] [-m] [-g] [-sh] [-w] [-v]

V3ps prints statistics a 3-dimensional object scene, including the volume, surface area, center of mass, dimensions, aspect ratios, orientation, and voxel statistics. Based on 3D moment analysis. Note that the geometric moments are the default, while densiometric moment calculations may be added using the -d flag (see below).

if=<output file>

specifies a VisionX (integer or byte) input file.

of=<output file>

specifies the output file. Textual output of the analysis will be produced (unless the -g flag is used, see below).

vs=<size>

specifies a voxel size (scale) to be used in calculation (default = 1.0).

vz=<size>

specifies the z-dimension voxel size (scale) to be used in calculation (default = 1.0). Note that this supersedes the value set by the vs parameter (for the z-dimension).

-d

perform additional calculations based on densiometric moments.

-vol

print only the volume and surface area.

-m

print the moment analysis.

-g

generate a vgen3d(1) parameter file depicting the ellipsoid of inertia.

-sh

generate parameters suitable for use evaluation in a Bourne shell script.

-w

generate parameters suitable for use evaluation in a wish shell script. The variables set in this script include the following:

gvol (volume)
gsa (surface area)
gvsr (volume/surface area ratio)
gmass (mass)
gmd (mean density of non-zero voxels)
gomd (overall mean density)
gsd (standard deviation)
gvar (variance)
gskew (skewness)
gkurt (kurtosis)
gsex (segment extent in x dimension)
gsey (segment extent in y dimension)
gsez (segment extent in z dimension)
gerxy (x/y extent ratio)
geryz (y/z extent ratio)
gerxz (x/z extent ratio)
gdiml (length of ellipsoid of inertia)
gdimw (width of ellipsoid of inertia)
gdimh (height of ellipsoid of inertia)
garlh (length/height ratio)
garlw (length/width ratio)
garwh (width/height ratio)
grr (orientation angle: roll (degrees))
grp (orientation angle: pitch (degrees))
gry (orientation angle: yaw (degrees))

These variables all correspond to calculations based on the voxel data and geometric moments. If the -d flag is specified, an additional set of similar variables will be output, each prefixed with the character "d" (instead of "g"), corresponding to those derived from the densiometric moments. For example, ddiml is the length of the ellipsoid of inertia dervied from the densiometric moments, etc.

-v

verbose operation. Prints all volume, surface, center of mass, dimension, aspect ratio, orientation, and statistical data.

If -m option is specified, 3D moment analysis is performed up to the order p + q + r <= 3. The output prefixes for geometrical moments are as the following: "Gmom" for raw, "Gmu" for central, "Gms" for scale-normalized and "Gmrot" for standard (aligned with principal axes) moments. For densiometric moments, "D" prefix used instead of "G". Standard densiometric moments are aligned with the principal axes obtained from geometrical moments.

Note, that indexing convention of moment orders is r, q, p or [z][y][x] for all moment types. This is opposite to the notation used in [Reeves-Wittner, 1983].

vps(1), vgen3d(1)

W. J. Kostis and A. P. Reeves