MEAN_SCALE

Section: User Commands (1)
Updated: MARCH 15, 1992
Index Return to Main Contents
 

NAME

mean_scale - scale an image to have a given mean or other feature  

SYNOPSIS

mean_scale [-a] [-A x y [w [h]] [-B-b[#]] [-c] [-C "sp ss"] [-e[#]] [-E #]
         [-f #] [-G] [-l #] [-m #] [-n # [#s] [-s #] [-S[#]] [-T] [-t[#]]

         [-w[#]] [-W #] [-z] [-M] [<] infilename [> -o filename]
 

DESCRIPTION

mean_scale corrects shift gray value across frames in a 3D image according to a mean value. The mean value can be average bright (default), or mean gray value in given area (-A), or the weight mean of the main object brightness (-B), or make all background to the same level (-b), or pick the 4 corners mean value as the adjusting base (-C).  

OPTIONS

-A x y [width [height]]
using average gray value in a given Area (center at x..y with window size w * h [default is 16x16]) as mean-scale reference.
-B[#]
mean_scale to weight balanced brightness. The default is average mean.
-b[#]
make all backgrounds have same value. If a value is supplied, then make the backgrounds have that value. option, and the result is not satisfied, use `tuner' to find average value of valley across frames, and use this average value as the main-threshold value.
-C start_position square_size
choose corners as background.
-c
mean_scale to ceiling. The default is mean_scale to floor. This option will be used with the
-B -C and -b options.
-e[#]
enhanced mode. # is enhance factor for trying on the worst case. No necessary to use it at regular time.
-E #
End frames are handled specially. if # < 0, special on first # frames (0..#); If # > 0, special on last # frames (n-#..n)
-F #
overflow value handle Factor. Default=1. If F=1.5, then when overflow happened, that pixel value = max / F. It is used for avoiding to brightness in a certain case.
-f[#]
foreground threshold. A value won't be changed if the value is lower then this threshold.
-h[#]
height percentage from the top of a hill. It'd better work with -S option. It is defaulted to 50%.
-G
generate a file which name is input file name plusing all options and suffix
-l # -m #
low and main thresholds - default l=10, main threshold `-m' depends on the mean_scale scheme. If use default m with
-n # [#s]
number of frames being processed [start from frame #].
-s #
set sample width. Default=4.
Range 3-7 for byte, 4-9 for short and 5-15 for long. The larger the width, the less peaks.
-S[#]
smoothing search. This is a time consuming method for precise image processing. The following number is smoothness. Larger numbers indicate more smoothness. The range is 1 to 15 (default=2).
-T
Test single frame (a 2D image).
-t[#]
threshold. Default = 32. A value won't be changed if the value is lower then this threshold.
-V #
valley position. The first valley in main chart is used if -v without -V.
-v[#]
dig valley with width #. It will help to separate the foreground and background. The default valley width is 12.
-W #
minimum peak foot width. The default = 2.5 * Sample_width.
-w[#]
pseudo-weight percentage from a peak top. This is used with the -S option. Actually, it's height percentage from hilltop.
-z
count zeros in each frame.
-M
print important status messages.
-o
this option is used machines such as the PC which require binary output file modes to be specified on open. No space is allowed between the switch and the filename.
-a
adjust float input automatically.
 

NOTE

The input can be one of the following type images:
         HIPS, FITS, GIF, ICC, RLE, PNM, SUN-Raster, and TIFF

The output is a HIPS image.  

SEE ALSO

elastic(1), mainpeak(1), tuner(1)  

AUTHOR

Jin Guojun - 1/11/91


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
NOTE
SEE ALSO
AUTHOR

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