VNGRP

VisionX V4

NAME

vngrp − Nodule group management utility (1.03)

SYNOPSIS

vngrp [-H] [n=<value>] [g=<value>] [i=<value>] [-d] [-s] [-i] [-g] [-nd] [-D] [-SH] [-GH] [of=<outputfile>] [im=<value>] [th=<value>] [t2=<value>] [-m] [-a] [-A] [mat=<value>] [-v] [-]

DESCRIPTION

vngrp is a script that manages the grouping of nodules. The nodule groups are stored in the grp.en file. In the grp.en file, a nodule group number is prefixed with ’g’, and contains a list of nodules. Each nodule number in the list is prefixed with an ’n’. The groupings are stored in a grp.en file with the following format:

grps=g1,g3,g4
g1=n1,n3,n8
g4=n2,n5
g3=n6,n7

Note that the group names do not have to be in order numerically (but they must have the g prefix). Each list of nodules in a group is indexed by a number from 1 to the number of elements in the group.

The script provides three basic functions: manual grouping, web-page generation, and auto grouping.

MANUAL GROUPING OPTIONS

The manual grouping options can create new groups, delete groups, insert nodules into groups, delete entries in a group, delete a nodule, set an entry in a group, and output the group containing a nodule.

	n=		The Nodule number.
	g=		The Group number (default=0: new group)
	i=		The Index in a group (default=0: append to end of group)
	-d		delete the entry at index i of group g
	-s		set index i of group g to nodule n
	-i		insert nodule n into group g at index i. if g=0 then a new group is formed. if i=0 then the nodule is appended to the end of the group
	-g		output the group number containing nodule n
	-nd		delete nodule n. this removes the images generated by vban and sets the n?delete flag in the nod.en file.
	-D		delete group g from grp.en file.

WEB GROUPING OPTIONS

The web-grouping options are used to generate HTML pages for the web-based grouping system. There are two types of pages; the selection page is used to choose the group numbers, and the viewing page is used to view the defined groups. These pages require thumbnails of the nodule, which should be generated externally.

	-SH		Generate a group selection HTML form page.
	-GH		Generate a group view HTML page.
	of=		the name of the HTML page (default=stdout).
	im=		the path of the thumbnail images of the nodules. for example, if im=./foo/nthumb then the image thumbnails will be called: ./foo/nthumb1.gif, ./foo/nthumb2.gif, ...etc.

AUTO GROUPING OPTIONS

The auto-grouping feature finds the best match to the nodule n and adds it to the appropriate group.

	th=		Grouping threshold 1 (default=150)
	t2=		Grouping threshold 2 (default=100) -- currently not used
	-m		Output the best match to nodule n (doesn’t apply the grouping).
	-a		Automatically match and group nodule n
	-A		Automatically match and group all ungrouped nodules.
	mat=		Calculate a matrix of matching values for nodule n

OTHER OPTIONS

And in case you wanted to see what was going on...

-v

verbose mode

CONSTRAINTS

Must be run in the same directory as the grp.en file.

BUGS

SEE ALSO

v3metric(1), v3reg(1).

AUTHOR

A. B. Chan, Fall 2001