NAME ARCMAP -- reads 1 or 2 ARCinfo gen files and creates an AVS geometry AUTHOR Kathy Pearson, MCNC, kathyp@mcnc.org, (919) 248-9240 SUMMARY 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 DESCRIPTION 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. INPUTS Input Parameters initial settings input from the GET MODEL MAP module OUTPUTS 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) PARAMETERS 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 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. -------------------------------------------------------------------------