NAME
	field stats - Provide global field statistics as parameters

AUTHOR INFORMATION
	John Tee
	AVS Inc. Consultant
	17 Dawnay Road, Great Bookham, Leatherhead, Surrey KT23 4PE, UK

SUMMARY
	Name	field stats
	Type	Mapper
	Inputs	input - 	field
	Outputs	float -	minimum
		float -	maximum
		float -	mean
	Parameters
	Name		Type	Default		Min/Max
	Min scale	float	1		0 to 2
	Max scale	float	1		0 to 2
	Mean scale	float	1		0 to 2
		

DESCRIPTION:
    FIELD STATS returns the minimum, maximum and mean values of a field
as floating point parameters.  It allows each of these parameters to be
scaled by its own scale factor.

One application of FIELD STATS is to create a colormap which is adapted
to the range of values in the field (as COLOR RANGE does), but allowing
the user to adjust the range manually.

INPUTS
	input - field

OUTPUTS
	Minimum - float
	Maximum - float
	Mean    - float

PARAMETERS
	Min scale
Applies a scale factor to the value output from the Minimum port.
	Max scale
Applies a scale factor to the value output from the Maximum port.
	Mean scale
Applies a scale factor to the value output from the Mean port.

EXAMPLE 1
	In this example, the colormap is adjusted automatically to the
range of the data, and the user can also adjust the colormap manually
by using the Min scale and Max scale controls.

	READ IMAGE	(read in mandrill.x)
	    |
	LUMINENCE
	    |______________
	    |              |
	    |        FIELD STATS
	    |        (Min)  (Max)
	    |          |      |
	    |       (Upper) (Lower)
	    |       (Limit) (Limit)
	    |      GENERATE COLORMAP
	    |   ___________|
	    |  |
	COLORIZER
	    |
	IMAGE VIEWER
           

SOURCE FILE:	field_size.c

SEE ALSO:	COLOR RANGE (User Module Library)

LIMITATIONS: