Image Statistical Functions
[Image Container]

Collaboration diagram for Image Statistical Functions:

Files
file	psImageStats.h
	Routines for calculating statistics on images.
Functions
psStats *	psImageStats (psStats *stats, const psImage *in, const psImage *mask, psS32 maskVal)
	This routine must determine the various statistics for the image.
psHistogram *	psImageHistogram (psHistogram *out, const psImage *in, const psImage *mask, psU32 maskVal)
	Construct a histogram from an image (or subimage).
psPolynomial2D *	psImageFitPolynomial (psPolynomial2D *coeffs, const psImage *input)
	Fit a 2-D polynomial surface to an image.
psImage *	psImageEvalPolynomial (psImage *input, const psPolynomial2D *coeffs)
	Evaluate a 2-D polynomial surface for the image pixels.

---

Function Documentation

psImage* psImageEvalPolynomial (  psImage *  input, const psPolynomial2D *  coeffs )

Evaluate a 2-D polynomial surface for the image pixels. Given the input polynomial coefficients, set the image pixel values on the basis of the polynomial function. This function must be defined for the following types: psS8, psU16, psF32, psF64. Returns: psImage* the resulting image Parameters: input  input image coeffs  coefficient structure carries in desired terms

psPolynomial2D* psImageFitPolynomial (  psPolynomial2D *  coeffs, const psImage *  input )

Fit a 2-D polynomial surface to an image. The input structure coeffs contains the desired order and terms of interest. This function must be defined for the following types: psS8, psU16, psF32, psF64. Returns: psPolynomial2D* fitted polynomial result Parameters: coeffs  coefficient structure carries in desired terms & target

psHistogram* psImageHistogram (  psHistogram *  out, const psImage *  in, const psImage *  mask, psU32  maskVal )

Construct a histogram from an image (or subimage). The histogram to generate is specified by psHistogram hist (see section 4.3.2 in SDRS). This function must be defined for the following types: psS8, psU16, psF32, psF64. Returns: psHistogram* the resulting histogram Parameters: out  input histogram description & target in  Image data to be histogramed. mask  mask data for image (NULL ok) maskVal  mask Mask for mask

psStats* psImageStats (  psStats *  stats, const psImage *  in, const psImage *  mask, psS32  maskVal )

This routine must determine the various statistics for the image. Determine statistics for image (or subimage). The statistics to be determined are specified by stats. The mask allows pixels to be excluded if their corresponding mask pixel value matches the value of maskVal. This function must be defined for the following types: psS8, psU16, psF32, psF64. Returns: psStats* the resulting statistics result(s) Parameters: stats  defines statistics to be calculated in  image (or subimage) to calculate stats mask  mask data for image (NULL ok) maskVal  mask Mask for mask

---