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