MAINPEAK

Section: User Commands (1)
Updated: JAN. 28, 1990
Index Return to Main Contents
 

NAME

mainpeak - find main object in an image file for different type of image.  

SYNOPSIS

meanpeak [-l #] [-u #] [-w #] [-L #] [-U #] [-n #] [-F] [-a] [-c] [-e]
          [-gd #] [-M [#]] [-O #] [-p #] [-z] [<] input_image [> [-o]output_image]
 

DESCRIPTION

mainpeak finds the main object(s) in an image and picks the largest one (by default). This object usually is the main body. By using different threshold values, bandwidth and object number, mainpeak can pick out different object for output or display. The three thresholds are the most useful parameters for finding the main object. The -L, -U, -n and -O options are used to detect different objects. The output format defaults to byte format. Specifying -F will output the format to be the same as the input.  

OPTIONS

-F
force output format same as the input.
-M [#]
output object message. If no number # given, all messages will be printed onto screen, otherwise, only the first # pieces of information of objects are sent to the screen.
-p#
maximum number of peaks which can be detected and held in memory for one frame. The default is 48 for byte; 192 for short and 768 for long. When the message
         "There are more than xxx peaks in frame #"
is given and picture is not satisfying, it means that you need more space to hold more objects. You can use the -p option to set more bins (# > xxx) to find more objects as long as the memory is available. However, if the output image is good enough, more bins (peaks) may be not necessary.
-L#
To get #th Lower object (Shift to #th lower value object).
-U#
To find #th Upper object.
-O#
Offset for both ends.
-n#
total objects from lower one.
-a
automatically adjust main object position.
-c
clip top value to 0 for nonbyte-formatted images.
-d #, -g #
these two options set the bandwidth for adjusting.
-e
extend the ranges for preprocessed or preenhanced image.
-l#
set lower threshold value. The default is 5.
-m#
set middle level threshold value. The object whose frequency is between middle threshold and upper threshold will be picked out.
-u#
set the upper threshold value so that any objects which have a higher frequency value than this threshold will be omitted. (It is a lowpass filter.) -u is a very important option to avoid finding too many objects in the image that contains a lot of objects.
-w#
hill foot width (bandwidth of spectrum). The default is 0 - find widest one. A good value is > 256 for the main object. Smaller values can distinguish smaller objects.
-z
count zeros value.
-o
option is used for machines such as the PC which require binary output file modes.
 

EXAMPLES

meanpeak -u200 nov309run97_img.h | xhips

meanpeak -e nov309run97_img.h | xhips

meanpeak -M saturn | xhips

in the second example, -e is used instead of -u200 for doing main body searching.  

SEE ALSO

elastic(1), mean_scale(1), spring(1)  

AUTHOR

Jin, Guojun - Jan. 22, 1991


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
SEE ALSO
AUTHOR

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