ImageStats

Files
file	psImageStats.h
	Routines for calculating statistics on images.
Functions
psStats *	psImageStats (psStats *stats, const psImage *in, const psImage *mask, psMaskType maskVal)
	This routine must determine the various statistics for the image.
psHistogram *	psImageHistogram (psHistogram *out, const psImage *in, const psImage *mask, psMaskType 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.
long	psImageCountPixelMask (psImage *mask, psRegion region, psMaskType value)
	Returns the number of pixels in the image region which satisfy any of the mask bits.

---

Function Documentation

long psImageCountPixelMask (  psImage *  mask, psRegion  region, psMaskType  value )

Returns the number of pixels in the image region which satisfy any of the mask bits. An error (eg, invalid image, invalid region) results in a return value of -1. The vector must be U8. Returns: long: the number of pixels counted Parameters: mask  input image to count region  input region of image value  the mask value to satisfy

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 input  input image

psHistogram* psImageHistogram (  psHistogram *  out, const psImage *  in, const psImage *  mask, psMaskType  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, psMaskType  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 value for mask

---