VATTRATIO

VisionX V4
NAME

vattratio − computes primary, secondary and total attachment ratios for a given set of of candidates

SYNOPSIS

vattratio [if=<inputimage>] [ic=<incandfile>] [of=<outcandfile>] [th=<threshold>] [-g] [-t] [-v]

DESCRIPTION

vattratio calculates primary, secondary and total attachment ratio for the list of nodule candidates. First, candidate region is separated into foreground and background using the <threshold>. Then, a spherical shell with diameter slightly higher than the candidate’s size is constructed around the candidate center. Foreground voxels within this shell are grouped into connected regions. Area of primary and secondary attachment is approximated as a number of voxels comprising first and second largest connected regions respectively. Final attachment measure is calculated as a ratio of attachment area to the effective crossectional area of the candidate volume enclosed in the shell.

If <threshold> is not specified, it is computed automatically as the average between mean voxel intensity in positive and negative volumes of support of LOG kernel corresponding the candidate.

If [-g] option is specified, the minimum ratios are computed for the set of spherical shells of gradually increasing size.

OPTIONS

if=

input image in short format

ic=

input candidate file

of=

output candidate file, containing all columns from the input candidate file plus additional columns with computed ratios

th=

threshold for foreground/background separation

-g

calculate minimum ratios for for the set of sperical shells of gradually increasing size

-t

use tab-separated format instead of default VisionX feature format both for input and output candidate files; input file may have arbitrary number of columns, however the first three must be the following: candidate index, x,y,z coordinates and diameter (in mm)

-v

verbose mode; gives some runtime information

TODO

* must support arbitrary set of diameters for -g option

SEE ALSO

vloggen(1), vloggenw(1), vlogtype(1), vlogratio(1), vairdist(1), vpsdist(1), vcurvature(1), vcompact(1)

AUTHOR

Sergei Fotin, August 2008