---
name: "im_stats"
section: "3"
platform: "linux"
package: "libvips-dev"
version: "7.20.7-1+b3"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/im_stats"
---

# im\_stats(3)

calculate many image statistics in a single pass

## NAME

im\_stats - calculate many image statistics in a single pass

## SYNOPSIS

**#include \<vips/vips.h\>**

**DOUBLEMASK \*im\_stats(in)**\
 **IMAGE \*in;**

## DESCRIPTION

Find many image statistics in a single pass through the PELs. Returns a DOUBLEMASK of 6 columns by n+1 (where n is number of bands in image in) rows. Columns are statistics, and are, in order: minimum, maximum, sum, sum of squares, mean, standard deviation. Row 0 has statistics for all bands together, row 1 has stats for band 1, and so on.

Non-complex images only!

## RETURN VALUE

NULL on error.

## SEE ALSO

[im\_avg(3)](/im_avg/3.md), [im\_deviate(3)](/im_deviate/3.md)

## COPYRIGHT

National Gallery, 1992