GRAPH2D -- generate an X-Y plot, control graph viewer parameters, and
optionally output PostScript
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.
-------------------------------------------------------------------------