NAME	GET MODEL MAP -- generate map and crop information based on selected
			map	 

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

SUMMARY

	Name		GET MODEL MAP	

	Type		data_input	

	Inputs		filename		(string)	

	Outputs		map info		(string)
			crop info		(string)

	Parameters
			Name		Type		Def	Min	Max
			----		----		---	---	---
			map dir		string		NULL	--	--

DESCRIPTION

This module creates information strings for optional use by the ARCMAP and
NEW CROP modules.  These strings are written out within the GET MODEL MAP
module with the following commands:

sprintf(mapinfo_string,
"%s/%s %s/%s %d %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g %g\n",
			map_dir, file1, map_dir, file2, negatex, z1, z2,
                        x0, x1, y0, y1,
                        gridx0, gridx1, gridy0, gridy1,
                        clipx0, clipx1, clipy0, clipy1,
                        boundx0, boundx1, boundy0, boundy1);
 
sprintf(cropinfo_string, "%g %g %g %g %g %g %g %g %g %g %g %g\n",
                        gridx0, gridx1, gridy0, gridy1,
                        clipx0, clipx1, clipy0, clipy1,
                        boundx0, boundx1, boundy0, boundy1);
 

All of the information output by this module is gleaned from the specified
"filename", a map description file.  The ".gen" files specified therein are
located in the "map dir" directory.  An example description file looks like
this:

UAM-AREAL                               # model
NY                                      # domain 
UTM                                     # data coordinates
nj.gen                                  # domain map 
cnn.gen                                 # secondary map for outline
_____                                   # special map note
520000  768000  4460000 4660000         # (xmin xmax ymin ymax) map corners
0 30 0 24                               # (xmin xmax ymin ymax) grid corners
0 30 0 24                               # (xmin xmax ymin ymax) clip corners
1 29 1 23                               # (xmin xmax ymin ymax) boundary cond
6 6                                     # layer height for map1 and map2

(where the special map note indicates whether to negate X for west longitude
values).

INPUTS

filename	the full path name of the description map file selected    

OUTPUTS

map info	a string of map parameters to be optionally used by ARCMAP

crop info	a string of crop parameters to be optionally used by NEW CROP 


PARAMETERS

map dir		the full path name of the directory containing ARCinfo 
		gen files

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.
-------------------------------------------------------------------------