GETOBJ

Section: User Commands (1)
Updated: 1 September 1990
Index Return to Main Contents
 

NAME

getobj - select objects out of an image  

SYNOPSIS

getobj [-t NN][-b NN][-m NN][-a][-o][-v][-c NN NN][-f fname] < inseq > outseq  

DESCRIPTION

getobj selects an arbitrary number of distinct objects from an image, and sets the remaining image to a uniform background value (usually zero). This can be used when only certain objects are of interest, and can be used to eliminate background noise around a central object. The program can also be helpful in that by making the entire background a constant value, data compression programs will perform better. This program works on hips formatted images of type int, short, and byte.  

OPTIONS

The following options are available:
-t threshold value
All grey level values below this value are discarded. Default value is 50.
-b background value
All location not determined to be part of an object are set to this value. Default value is 0.
-m minimum size object
Any object smaller than this size is ignored. Usually used in conjunction with the -a option. (default = 10)
-a
Find all objects in the image.
-o
Output is binary. All pixels in objects are set to 255, and all other pixels are set to 0.
-v
Verbose mode: displays information along the way. Useful on slow machines to know the current status of the program.
-c row column
The row, column point which is inside the desired object. If this point is not in an object, the program exits. If the point is not specified, getobj uses the first object it finds from the center of the image.
-f value file
When this argument is given, (row,col) values of object locations are read from this file. The format of the file should be an int telling the number of points in the file, followed by a list of points. For example:
    "2
     100 120
     200 210" means use 2 seed values, one at (100,120), and the other at (200, 210). This option over-rides the -c option.

 

AUTHOR

Brian Tierney, LBL email: bltierney@lbl.gov  

SEE ALSO

getobj3d(1)  

DIAGNOSTICS

getobj will give unpredictable results if the objects are not cleanly separated. This program also works on a sequence of images. However, the seed locations specified by the -c or -f options must be the same for all frames.

This program may run out of memory is the object size is too large or if it is given a non-binary image.  

BUGS

Report to Brian Tierney.


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
AUTHOR
SEE ALSO
DIAGNOSTICS
BUGS

This document was created by man2html, using the manual pages.
Time: 01:45:21 GMT, December 05, 2024