field stats - Provide global field statistics as parameters

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

	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