<!-- manual page source format generated by PolyglotMan v3.2, -->
<!-- available at http://polyglotman.sourceforge.net/ -->
<html>
<head>
<title>STATS(3) manual page</title>
</head>
<body bgcolor='white'>
<a href='#toc'>Table of Contents</a><p>
<h2><a name='sect0' href='#toc0'>Name</a></h2>
im_avg, im_deviate, im_min, im_minpos, im_max, im_maxpos - find the
mean, standard deviation, minimum and maximum of an image
<h2><a name='sect1' href='#toc1'>Synopsis</a></h2>
<b>#include
<vips/vips.h></b>
<p> <b>int im_avg(im, out)</b> <br>
<b>IMAGE *im;</b> <br>
<b>double *out;</b>
<p> <b>int im_deviate(im, out)</b> <br>
<b>IMAGE *im;</b> <br>
<b>double *out;</b>
<p> <b>int im_min(im, out)</b> <br>
<b>IMAGE *im;</b> <br>
<b>double *out;</b>
<p> <b>int im_minpos(im, xpos, ypos, min)</b> <br>
<b>IMAGE *im;</b> <br>
<b>int *xpos, *ypos;</b> <br>
<b>double *min;</b>
<p> <b>int im_max(im, out)</b> <br>
<b>IMAGE *im;</b> <br>
<b>double *out;</b>
<p> <b>int im_maxpos(im, xpos, ypos, max)</b> <br>
<b>IMAGE *im;</b> <br>
<b>int *xpos, *ypos;</b> <br>
<b>double *max;</b>
<p>
<h2><a name='sect2' href='#toc2'>Description</a></h2>
These functions find the mean, standard deviation,
minimum, maximum of an image. They operate on all bands of the input image.
Use <a href='im_stats.3.html'><b>im_stats(3)</b></a>
if you need to calculate on bands separately. All computations
are carried out in double precision arithmetic. The standard deviation
is calculated using the formula:
<p> Var{E} = 1 / (N - 1) * (E{X^2} - E{X}^2
/ N)<br>
stdev{E} = sqrt(Var{E}).<br>
<p> <a href='im_avg.3.html'><b>im_avg(3)</b></a>
finds the average of an image pointed by im. Takes as input
any non-complex image format and returns a double at the location pointed
by out.
<p> <a href='im_deviate.3.html'><b>im_deviate(3)</b></a>
finds the standard deviation of an image pointed
by im. Takes as input any non-complex image format and returns a double
at the location pointed by out.
<p> <a href='im_min.3.html'><b>im_min(3)</b></a>
finds the the minimum value of
the image pointed by im and returns it at the location pointed by out.
Takes as input any image format and returns a double at the location pointed
by out. If input is complex the min square amplitude (re*re+im*im) is
returned.
<p> <a href='im_minpos.3.html'><b>im_minpos(3)</b></a>
finds the the minimum value of the image pointed
by im and returns it at the location pointed by out. The coordinates of
the last occurrence of min is returned at locations pointed by xpos, ypos.
If input is complex the min square amplitude (re*re+im*im) is returned.
<p> <a href='im_max.3.html'><b>im_max(3)</b></a>
finds the the maximum value of the image pointed by im and returns
it at the location pointed by out. If input is complex the max square
amplitude (re*re+im*im) is returned.
<p> <a href='im_maxpos.3.html'><b>im_maxpos(3)</b></a>
finds the the maximum
value of the image pointed by im and returns it at the location pointed
by max. The coordinates of the last occurrence of max is returned at locations
pointed by xpos, ypos. If input is complex the max square amplitude (re*re+im*im)
and its last occurrence is returned.
<h2><a name='sect3' href='#toc3'>Return Value</a></h2>
All functions return 0
on success and -1 on error.
<h2><a name='sect4' href='#toc4'>See Also</a></h2>
<a href='im_exptra.3.html'>im_exptra(3)</a>
, <a href='im_lintra.3.html'>im_lintra(3)</a>
, <a href='im_abs.3.html'>im_abs(3)</a>
,
<a href='im_stats.3.html'>im_stats(3)</a>
.
<h2><a name='sect5' href='#toc5'>Copyright</a></h2>
<br>
N. Dessipris
<h2><a name='sect6' href='#toc6'>Author</a></h2>
N. Dessipris - 24/04/1991 <br>
J. Cupitt - 21/7/93
<p> <p>
<hr><p>
<a name='toc'><b>Table of Contents</b></a><p>
<ul>
<li><a name='toc0' href='#sect0'>Name</a></li>
<li><a name='toc1' href='#sect1'>Synopsis</a></li>
<li><a name='toc2' href='#sect2'>Description</a></li>
<li><a name='toc3' href='#sect3'>Return Value</a></li>
<li><a name='toc4' href='#sect4'>See Also</a></li>
<li><a name='toc5' href='#sect5'>Copyright</a></li>
<li><a name='toc6' href='#sect6'>Author</a></li>
</ul>
</body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
7faa4cd12598db7d59564e3dc9a0913c
>
files
>
385
