NAME	LABELS UNITS -- create a label based upon the input field and
			input slice axis and output a label geometry

AUTHOR	Kathy Pearson, MCNC, kathyp@mcnc.org, (919) 248-9240

SUMMARY

	Name		LABELS UNITS	

	Type		mapper	

	Inputs		input field		(field)	
			input slice axis	(string)

	Outputs
			textout			(string)

	Parameters
			Name			Type	Def	Min	Max
			----			----	---	---	---
			Label Slice Only	(toggle)  0	  0	  1

DESCRIPTION

The LABELS UNITS module reads from an input field the labels and units
as well as the coordinates of the data.  If "Label Slice Only" is turned on,
the output label will appear as SPECIES(UNITS) SLICE, e.g., "O3 (PPM) Layer 1".
If the toggle is turned off, the label will be more complicated indicating
slice plus the cropped bounds of the other two dimensions, e.g.,
"O3 (PPM) Row 1-30 Col 1-28 Layer 1".	

INPUTS

input field	field	

input slice
 axis		string indicating that the data field has been sliced on
		"X", "Y", or "Z"

OUTPUTS

textout		a label showing the SPECIES, its units, and its slice
		with optional inclusion of other dimensions

PARAMETERS

Label Slice
 Only		toggle indicating whether other dimensions should be included
		in the output label	

EXAMPLE

RELATED MODULES

LIMITATIONS

SEE ALSO

(MCNC Visualization Plan)						11/93
-------------------------------------------------------------------------
The MCNC Environmental Programs Group has created this module as part of a
suite of AVS demo modules, networks, and sample data sets to demonstrate 
the functionality of its visualization prototype for an Environmental 
Decision Support System (EDSS).  This system provides a unified method of 
analysis and visualization for data output from different environmental air 
quality models.  Remotely, standard output files from the following models 
can be read into AVS:

        ROM (Regional Oxidant Model)
        RADM (Regional Acid Deposition Model), low res and high res
        RADM (Regional Acid Depostion Model) Emissions, low res
        UAM (Urban Airshed Model, regulatory version)
        UAM (Urban Airshed Model, AREAL research version)
        UAM Wind (Urban Airshed Model, regulatory version)
        MCNC ALPHA-Prototype netCDF files

Alternatively, xdr portable binary AVS fields can be created from these
data types and accessed directly from the local workstation.

You can download these modules individually from the IAC using anonymous
ftp to the appropriate directories /avs_modules at avs.ncsc.org.  
If you would like to download the entire suite of modules, networks, and
sample datasets at the same time, the IAC recommends that you use 
anonymous ftp to grab the following file from avs.ncsc.org -

/sample_data/avs_data/MCNC_Env_Pgms/MCNC_Env_Pgms.tar.Z

This contains all source code to all local and remote modules, as well as
all of the sample datasets, networks, documentation, installation, and
usage notes.
-------------------------------------------------------------------------