VTBBOXVisionX V4 NAME

vtbbox − return a tight bounding box around a image ROI

SYNOPSIS

vtbbox if= [z=] [-2d] [-w] [-sh] [-c] [-f] [-v]

DESCRIPTION

vtbbox finds a tight bounding box (bbx) around the non-zero region of the input. By default, the 3D bbx is considered. If -2d is specified, the 2D bbx is output for each axial slice. If z= is specified, the 2D bbx for the specified slice is output. The low and high frame numbers can be output instead of zl= and zh= coordinates using -f option.

The points of interest are defined to be points located at the bbx (i.e, with coordinates of x=xl, x=xh, y=yl, y=yh, z=zl or z=zh). If -c is specified, the coordinates of the points of interest are output.

vtbbox is a replacement for vlngwind which is now depreciated. ; is now used as separator for the -sh flag.

OPTIONS

if=

input file (byte, short, float, double, and int are accepted)

[z=]

output bbx coords for the specified slice

[-2d]

output bbx coords for each axial slice

[-w]

output in wish format

[-sh]

output in bourne shell format

[-c]

output coordinates of points of interest, which are located at the bbx

[-f]

output low and high frame numbers instead of zl and zh coordinates

[-v]

verbose information

RETURNED VARIABLES

The -w and -sh options return the results as sets of variables suitable for the evaluation by the respective interpreters.
xl, xh, yl, yh, zl, zh

tight bbx of the input non-zero regions. E.g. xl is the lowest x coordinate of the input non-zero region; xh is the highest x coordinate of the input non-zero region.

xlx, xly, xlz

coordinates of the point of interest that are located at x = xl. Note that only point is output, although there may be multiple points with x = xl.

xhx, xhy, xhz

coordinates of the point of interest that are located at x = xh. Note that only point is output, although there may be multiple points with x = xh.

ylx, yly, ylz

coordinates of the point of interest that are located at y = yl. Note that only point is output, although there may be multiple points with y = yl.

yhx, yhy, yhz

coordinates of the point of interest that are located at y = yh. Note that only point is output, although there may be multiple points with y = yh.

zlx, zly, zlz

coordinates of the point of interest that are located at z = zl. Note that only point is output, although there may be multiple points with z = zl.

zhx, zhy, zhz

coordinates of the point of interest that are located at z = zh. Note that only point is output, although there may be multiple points with z = zh.

AUTHOR

A. P. Reeves Andinet Asmamaw, Shuang Liu, July 2015