<![CDATA[
<table cellspacing="0" cellpadding="0">
<tr height="150">
<td align="left"><img src="../../../../img/logo.gif" alt="IAC logo"></img></td>
<td width="100%" rowspan="2" align="left" valign="center">
<table cellspacing="0" cellpadding="0">
<tr>
<td>
<a name="ARC_MAP">
<table width="84%" border="0" align="center">
<tr bgcolor="FFFFAA" align="center">
<td nowrap width="15%" height="32">
<tt class="label">1792</tt></td>
<td nowrap width="100%">
<tt class="label">ARC_MAP</tt></td>
<td nowrap width="150"><tt class="label">04/21/94</tt></td>
</tr>
<tr><td align="left" colspan="3"><p>The ARCMAP module creates an AVS geometry by reading input from an ARCinfo gen file. The gen file structure is that of ARC segment number, a list of x-y coordinates of the segment polygon, and an 'END' statement. 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). 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 ftp/avs/Data/avs_dataMCNC_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.</p></td></tr>
<tr><td align="left" colspan="3"><table class="avs5_repository">
<tr valign="top"><td><b>Author:</b></td><td>Kathy Pearson, MCNC Environmental Programs</td></tr>
<tr><td><b>Version:</b></td><td>1.000</td></tr>
<tr><td><b>Language:</b></td><td>C</td></tr>
<tr>
<td><b>Path:</b></td><td>source/data_input/ARC_MAP/</td></tr>
</table></td></tr>
<tr><td align="left" colspan="3"><p>
<a href="ARC_MAP.shtml" target="_top">
<img src="../../../../../img/doc_mod.gif" border="0"
width="30" height="30"
alt="Module Document - ARC_MAP"></a>
<a href="source/data_input/ARC_MAP/ARC_MAP.tar.gz">
<img src="../../../../../img/targz.gif"
border="0" width="52" height="30"
alt="Archive - ARC_MAP.tar.gz"></a>
<a href="source/data_input/ARC_MAP/ARC_MAP.tar.Z">
<img src="../../../../../img/tarz.gif"
border="0" width="52" height="30"
alt="Archive - ARC_MAP.tar.Z"></a>
<a href="source/data_input/ARC_MAP/ARC_MAP.zip">
<img src="../../../../../img/zip.gif"
border="0" width="52" height="30"
alt="Archive - ARC_MAP.zip"></a>
</p></td>
</tr>
</table>
<br>
</td>
</tr>
<tr>
<td>
<!-- BEGIN CONTENT PAGE -->
<html>
<head>
<title>ARCMAP -- reads 1 or 2 ARCinfo gen files and creates an AVS geometry
</title>
</head>
<body bgcolor=#FFFFCC>
<h2>ARCMAP -- reads 1 or 2 ARCinfo gen files and creates an AVS geometry
</h2>
<h3>Name</h3>
<blockquote>
<pre>
ARCMAP -- reads 1 or 2 ARCinfo gen files and creates an AVS geometry
</pre>
</blockquote>
<h3>Author</h3>
<blockquote>
<pre>
Kathy Pearson, MCNC, kathyp@mcnc.org, (919) 248-9240
</pre>
</blockquote>
<h3>Summary</h3>
<blockquote>
<pre>
Name ARCMAP
Type data_input
Inputs Input Parameters (string OPTIONAL)
Outputs
Map Geometry (geometry)
Legend Info (string)
Parameters
Name Type Def Min Max
---- ---- --- --- ---
Map Data File 1 (browser) NULL -- --
Map Data File 2 (browser) NULL -- --
Expand for Tile (toggle) 0 0 1
Negate X (toggle) 0 0 1
Clip Boundary
Conditions (toggle) 0 0 1
Use Input
Parameters (toggle) 0 0 1
Z 1 (float) 0.0 UNBOUND UNBOUND
R 1 (float) 1.0 0.0 1.0
G 1 (float) 1.0 0.0 1.0
B 1 (float) 1.0 0.0 1.0
Z 2 (float) 0.0 UNBOUND UNBOUND
R 2 (float) 1.0 0.0 1.0
G 2 (float) 1.0 0.0 1.0
B 2 (float) 1.0 0.0 1.0
INPUT x min (float) 0.0 UNBOUND UNBOUND
INPUT x max (float) 0.0 UNBOUND UNBOUND
INPUT y min (float) 0.0 UNBOUND UNBOUND
INPUT y max (float) 0.0 UNBOUND UNBOUND
GRID x min (float) 0.0 UNBOUND UNBOUND
GRID x max (float) 0.0 UNBOUND UNBOUND
GRID y min (float) 0.0 UNBOUND UNBOUND
GRID y max (float) 0.0 UNBOUND UNBOUND
CLIP GRID x min (float) 0.0 UNBOUND UNBOUND
CLIP GRID x max (float) 0.0 UNBOUND UNBOUND
CLIP GRID y min (float) 0.0 UNBOUND UNBOUND
CLIP GRID y max (float) 0.0 UNBOUND UNBOUND
BOUND GRID x min(float) 0.0 UNBOUND UNBOUND
BOUND GRID x max(float) 0.0 UNBOUND UNBOUND
BOUND GRID y min(float) 0.0 UNBOUND UNBOUND
BOUND GRID y max(float) 0.0 UNBOUND UNBOUND
</pre>
</blockquote>
<h3>Description</h3>
<blockquote>
<pre>
The ARCMAP module creates an AVS geometry by reading input from an ARCinfo
gen file. The gen file structure is that of ARC segment number, a list
of x-y coordinates of the segment polygon, and an 'END' statement. The last
segment is followed by an extra 'END' statement. Each vertex of the polygon
must lie within the "INPUT x-y min-max" range to be considered, and those
values are then indexed to the "GRID x-y min-max" corners. Lines between
vertices are only plotted if they lie within the "CLIP GRID x-y min-max"
range, and the Evans-Sutherland clipping algorithm is employed to determine
whether points fall inside or outside the clipping edge. If one point of a
line is inside and the other is outside, this algorithm sets the coordinates
for the line between the inside point and the clipping edge. If the toggle
is set to "clip boundary conditions", the BOUND GRID x-y min-max values
are inserted as the new CLIP GRID x-y min-max values.
One or two maps may be drawn using this module, using the colors and the
layer height specified for each. Two maps are often needed since one may
show multi-state areas, and the other may highlight one state or one county of
special interest.
The toggle "expand for tile" is set, the entire map is expanded by one-half
cell size on all four edges of the grid rectangle. This is useful for tile
maps that are center-based squares of cell size one. When the standard AVS
"field to mesh" module is used instead, the toggle should be turned off since
mesh values are edge-based interpolated values.
</pre>
</blockquote>
<h3>Inputs</h3>
<blockquote>
<pre>
Input Parameters initial settings input from the GET MODEL MAP module
</pre>
</blockquote>
<h3>Outputs</h3>
<blockquote>
<pre>
Map Geometry geometry for one or two maps
Legend Info output information for optional use in NEW LEGEND module;
string contains four values for vertical legends
(x offset, y offset, x scale, y scale)
and four values for horizontal legends
(x offset, y offset, x scale, y scale)
</pre>
</blockquote>
<h3>Parameters</h3>
<blockquote>
<pre>
Map Data File 1 full path name of 1st ARCinfo gen file
Map Data File 2 full path name of 2nd ARCinfo gen file
Expand for Tile indicator of whether grid should be expanded by .5 cell
size over the whole perimeter
Negate X indicator that positive west longitude values should be made
negative (U.S. longitude coordinates, e.g.)
Clip Boundary
Conditions indicator that map boundary conditions should be clipped away
before display occurs
Use Input
Parameters indicator that the map info input string from the
GET MODEL MAP module should be used to set the clip parameters
for the map; if used, the following command reads the input:
sscanf(Input_Parameters,
"%s%s%d%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g%g",
file1, file2, &negate_x, &z1, &z2,
&minx, &maxx, &miny, &maxy,
&grid_minx, &grid_maxx, &grid_miny, &grid_maxy,
&clip_minx, &clip_maxx, &clip_miny, &clip_maxy,
&bound_minx, &bound_maxx, &bound_miny, &bound_maxy);
Z 1 z values to assign coordinates for the 1st map
R 1 red component of the color for the 1st map
G 1 green component of the color for the 1st map
B 1 blue component of the color for the 1st map
Z 2 z values to assign coordinates for the 2nd map
R 2 red component of the color for the 2nd map
G 2 green component of the color for the 2nd map
B 2 blue component of the color for the 2nd map
INPUT x min minimum X coordinate map boundary
INPUT x max maximum X coordinate map boundary
INPUT y min minimum Y coordinate map boundary
INPUT y max maximum Y coordinate map boundary
GRID x min minimum X grid coordinate map boundary
GRID x max maximum X grid coordinate map boundary
GRID y min minimum Y grid coordinate map boundary
GRID y max maximum Y grid coordinate map boundary
CLIP GRID
x min minimum X clip grid coordinate map boundary
CLIP GRID
x max maximum X clip grid coordinate map boundary
CLIP GRID
y min minimum Y clip grid coordinate map boundary
CLIP GRID
y max maximum Y clip grid coordinate map boundary
BOUND GRID
x min minimum X boundary grid coordinate
BOUND GRID
x max maximum X boundary grid coordinate
BOUND GRID
y min minimum Y boundary grid coordinate
BOUND GRID
y max maximum Y boundary grid coordinate
</pre>
</blockquote>
<h3>Example</h3>
<blockquote>
<pre>
</pre>
</blockquote>
<h3>Related modules</h3>
<blockquote>
<pre>
</pre>
</blockquote>
<h3>Limitations</h3>
<blockquote>
<pre>
</pre>
</blockquote>
<h3>See also</h3>
<blockquote>
<pre>
(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.
-------------------------------------------------------------------------
</pre>
</blockquote>
</body>
</html>
<!-- END CONTENT PAGE -->
</td>
</tr>
</table>
</td>
</tr>
<tr height="100%">
<td class="sideLink" width="25%" align="left" valign="top" nowrap="nowrap">
<p><a href="../../../../../general/index.shtml" target="_top">General Information</a></p>
<p><a href="../../../../../repository/index.shtml" target="_top">Repositories</a></p>
<p class="sideLinkLevel2"><a href="../../../../new/index.shtml" target="_top"> New Releases</a></p>
<p class="sideLinkLevel2"><a href="../../../../download/index.shtml" target="_top"> Download</a></p>
<p class="sideLinkLevel2"><a href="../../../../submit/index.shtml" target="_top"> Submit</a></p>
<p class="sideLinkLevel2"><a href="../../../../pfiles/index.shtml" target="_top"> Project Files</a></p>
<p class="sideLinkLevel2"><a href="../../../../avs5/index.shtml" target="_top"> AVS5</a></p>
<p class="sideLinkLevel3"><a href="../../../input.shtml" target="_top"> Data Input</a></p>
<p class="sideLinkLevel3"><a href="../../../filters.shtml" target="_top"> Filters</a></p>
<p class="sideLinkLevel3"><a href="../../../mappers.shtml" target="_top"> Mappers</a></p>
<p class="sideLinkLevel3"><a href="../../../output.shtml" target="_top"> Data Output</a></p>
<p class="sideLinkLevel3"><a href="../../../misc.shtml" target="_top"> Miscellaneous</a></p>
<p class="sideLinkLevel2"><a href="../../../../express/index.shtml" target="_top"> AVS/Express</a></p>
<p class="sideLinkLevel2"><a href="../../../../pog/index.shtml" target="_top"> Project Guidelines</a></p>
<p><a href="../../../../../usergroup/index.shtml" target="_top">User Group</a></p>
<p><a href="../../../../../training/index.shtml" target="_top">Training Materials</a></p>
</td>
</tr>
</table>
<table width="100%" border="0" cellspacing="0" cellpadding="0" bgcolor="c6c6e0">
<tr>
<td><img src="../../../../../img/foot1.gif" alt="IAC" width="155" height="25"></td>
<td width="100%"> Last Updated:
<!-- #BeginEditable "date-stamp" -->
26th November 2002
<!-- #EndEditable --></td>
</tr>
</table>
]]>