NAME GRAPH2D -- generate an X-Y plot, control graph viewer parameters, and optionally output PostScript AUTHOR Kathy Pearson, MCNC, kathyp@mcnc.org, (919) 248-9240 SUMMARY Name GRAPH2D Type data_output Inputs input_field (field 4D uniform 3-coord 1-vec float) input_label (string) input_time (string) input_slice_axis(string) input_crop_vars (string) Outputs none Parameters Name Type Def Min Max ---- ---- --- --- --- graph type (choice)mean -- -- window number (int) 1 1 4 X window location (int) 300 0 1000 Y window location (int) 50 0 1000 window width (int) 450 0 1000 window height (int) 450 0 1000 X axis min (float) 0.0 UNBOUND UNBOUND X axis max (float) 10.0 UNBOUND UNBOUND X axis tic placement (choice)outside X axis number of tics (int) 2 0 10 X axis tic label precision (int)0 0 6 Y axis min (float) 0.0 UNBOUND UNBOUND Y axis max (float) 10.0 UNBOUND UNBOUND Y axis tic placement (choice)outside Y axis number of tics (int) 2 0 10 Y axis tic label precision (int)0 0 6 threshold value (float) .12 UNBOUND UNBOUND percentile increment (choice) 5 %-tile output dir (string) NULL -- -- PostScript mode (choice) color PostScript output file# (int) 1 1 99 write PostScript (toggle) 0 0 1 autoscale (toggle) 0 0 1 legend position (choice) upper left delete (oneshot) 0 0 1 go (oneshot) 0 0 1 autogo (toggle) 0 0 1 output table (browser) NULL -- -- table file name (string) NULL -- -- DESCRIPTION The GRAPH2D module is an entire graphics management system for 2d plots. It creates a network including the AVS "graph viewer" and "image to postscript" modules, and it generates script files that are played to make ASCII files required as input to the graph viewer. Up to four 2d windows may be controlled by the module, and the settings will apply to the current window of focus, selected by the user and indicated by the red color band around the window. Before saving a network that includes the GRAPH2D module, the user should employ the "delete" button to remove the "network" consisting of the AVS "graph viewer" and the "image to postscript" modules. INPUTS input_field input_label e.g., "O3 (Layer 1)" input_time e.g., "3/3/88 12:00 GMT - 3/3/88 14:00 GMT" input_slice_axis e.g., "X", "Y", "Z" input_crop_vars parameters from the CROP module OUTPUTS (none) PARAMETERS graph type mean, distribution, min-med-max, or threshold graph window number range 1-4, selectable X-Y plot window X window location upper left hand corner x-coordinate in pixels Y window location upper left hand corner y-coordinate in pixels window width width of the current window in pixels window height height of the current window in pixels X axis min minimum X axis value X axis max maximum X axis value X axis tic placement nowhere, inside, outside, inside & outside X axis number of tics range 0-10, selectable number of X axis tics X axis tic label precision range 0-6, selectable # places after the decimal for X axis tic labels Y axis min minimum Y axis value Y axis max maximum Y axis value Y axis tic placement nowhere, inside, outside, inside & outside Y axis number of tics range 0-10, selectable number of Y axis tics Y axis tic label precision range 0-6, selectable # places after the decimal for Y axis tic labels threshold value value cells must exceed to be counted on the threshold graph percentile increment 1 percentile, 5 percentile, 10 percentile, 20 percentile, 25 percentile, 50 percentile output dir output directory where ASCII files created for use with the AVS graph viewer will reside PostScript mode color, greyscale PostScript output file# number to use for the PostScript output file extension write PostScript output the current 2d graph to PostScript autoscale indicator that the module should automatically scale the graph to the input instead of applying the 5 X-axis and 5 Y-axis parameters defined above legend position upper left, lower left, lower right, upper right delete indicator that the current graph viewer module and image to postscript module should be removed from the current network go indicator to begin execution of plot autogo indicator to begin execution of graph as soon as an input parameter changes output table text browser for X-Y values listing table file name full path name of file for storing the 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. -------------------------------------------------------------------------