If you are using
Navigator 4.x
or
Internet Explorer 4.x
or
Omni Web 4.x
, this site will not render
correctly!
Vis > visualization > 1d > xmgr
SYNOPSIS
xvgr (XView) or xmgr (Motif) [ -autoscale x|y|xy ] [ [ -noauto x|y|xy ] [
-arrange rows columns ] [ -cols columns ] [ -rows rows ] [ -device
device_number ] [ -batch batch_file ] [ -noask ] [ -eps ] [ -pipe ] [
-graph graph_number ] [ -maxplot number_of_sets ] [ -maxgraph
number_of_graphs ] [ -graphsets number_of_sets ] [ -graphtype graph_type
] [ -log x|y|xy ] [ -printfile graphics_output_file ] [ -type
XY_data_set_type ] [ -ihl IHL_formatted_file ] [ -nxy ] [ -xy ] [ -xydx ]
[ -xydy ] [ -xydxdx ] [ -xydydy ] [ -xydxdy ] [ -xyz ] [ -xyd ] [ -xyr ]
[ -hilo ] [ -block block_data ] [ -parameter parameter_file ] [ -pexec
parameter_string ] [ -results result_file ] [ -rvideo ] [ -mono ] [
-world xmin ymin xmax ymax ] [ -view xmin ymin xmax ymax ] [ -source
data_source ] [ -GXinvert ] [ -GXxor ] [ -maxcolors number_of_colors ] [
-bc ] [ -bs ] [ -nobs ] [ -dc ] [ -nodc ] [ -redraw ] [ -noredraw ] [
-refresh refresh_value ] [ -debug debug_level ] [ data_files ]
DESCRIPTION
ACE/gr is a data/function plotting tool for workstations or X-terminals
using X. A few of its features are:
o Polynomial regression, splines, running averages, DFT/FFT,
cross/auto-correlation.
o Plots up to 10 graphs with 30 datasets per graph.
o User-defined scaling, tick marks, labels, symbols, line styles,
colors.
o Batch mode for unattended plotting.
o Read and write parameters used during a session.
o Support through device independent graphic drivers for PostScript,
and FrameMaker .mif format.
OVERVIEW
While ACE/gr has a convenient point-and-click interface, most parameter
settings and operations are available through a command line interface
(found in Files/Commands). See the ACE/gr User's Manual for further
information. The following discusses command line parameters, data file
formats, hot keys, examples, and a few bugs. See the ACE/gr User's Manual
for a complete description of ACE/gr and its capabilities.
OPTIONS
Autoscale the axis denoted by "x" or "y" or both axes by "xy" overiding
any parameter file specified by the -p or -parameter option.
Suppress autoscaling the axis denoted by "x" or "y" or both axes by
"xy." Use -noauto if the data has imbedded parameter settings that set
first four graphs (0, 1, 2, 3) in a 2x2 matrix of graphs starting with
graph 0 in the lower left corner of the plotting surface.
Arrange the first 'rows' graphs in 'rows' rows.
Arrange the first 'cols' graphs in 'cols' columns.
Execute the commands in batch_file on startup.
-noask
Force the dialog or prompt requesting that files be overwritten to always
return TRUE (meaning that, yes, files will be overwritten without asking,
even if they exist). This supresses the yes/no dialog for the entire
ACE/gr session.
Set the hardcopy device to device.
The device numbering follows:
1 .. PostScript landscape
2 .. PostScript portrait
3 .. FrameMaker .mif landscape
4 .. FrameMaker .mif portrait
5 .. HPGL landscape
6 .. HPGL portrait
Write the graphics output to file graphics_output_file rather than spool
graphics data to a printer.
-eps
Set the PostScript driver to write EPS.
Assume file_name or the next source of data is in IHL format (a local
format)
Set the current graph type to logarithmic depending the the string "x" or
"y" or both axes by "xy".
-nxy
The format of the next data source is X1, Y1, Y2, ..., Yn.
The file block_data is a block data file.
The format of the next data source is data_set_type. Where data_set_type
is one of xydx (XY data with error bars along X), xydy (XY data with
error bars along Y), xydxdx (XY data with error bars along X of differing
values), xydydy (XY data with error bars along Y of differing values),
and
Read the parameter file parm_file.
Make graph_number the current graph. Graph_number is an integer between
0 and MAXGRAPH (usually 10).
Set the current graph type to graph_type. Where graph_type is one of xy,
logx, logy, logxy, or bar.
-rvideo
Exchange the color indices for black and white.
-mono
Ignore the number of available colors and use black and white on the
display only.
-GXinvert
Set the write mode to INVERT for rubberband lines and focus markers.
-GXxor
Set the write mode to XOR for rubberband lines and focus markers.
-dc
Allow double click operations overriding resource settings.
-nodc
Disallow double click operations overriding resource settings.
-redraw
Allow redraw for refreshing the canvas when the display does not do
backing store.
-noredraw
Do not do a redraw for refreshing the canvas when the display does not do
backing store.
Set the number of sets for each graph.
Set the number of graphs for the current session.
Set source for the next data file, the argument takes on the following
values:
disk - Data file is on disk.
pipe - Read from a pipe.
stdin - ACE/gr is in a pipe, read from standard input.
The setting selected here stays in effect until the next use of the
-source command line option is given. This differs from earlier versions
of ACE/gr.
Set the user coordinate system of the current graph to a rectangle
described by (xmin, ymin) and (xmax, ymax).
When all sets have been read, copy the set comments (usually the file
name from which the set was read) to the set legend labels and turn the
legend on.
-usage
Display a brief explanation of command line settings
On startup, ACE/gr will look for a .xmgrrc (XView) or .xmgrrc (Motif)
file in the users' home directory allowing the user to change the default
behavior of ACE/gr. The construction of the
.xmgrrc (XView) or .xmgrrc (Motif) file is the same as for a parameter
file.
REFERENCE
Note: all data are assumed to be delimited by tabs or blanks.
XY data sets:
xy ... Multiple xy data sets composed of X and Y one point per
line, data sets separated by '&' or some other non-digit character
(except '#' and '@', see below).
nxy ... Multiple xy data sets composed of X and Y1 Y2 Y3 Y4 ...
Y30. These data files may be concatenated as with the 'xy' format.
xydx ... Multiple xy data sets composed of X Y DX one point per
line, data sets separated by '&' or some other non-digit character. DX
is the value that will be printed as an error relative to X, i.e., the
point will be plotted with an error bar at (x+-dx, y).
xydy ... Multiple xy data sets composed of X Y DY one point per
line, data sets separated by '&' or some other non-digit character. DY
is the value that will be printed as an error relative to Y, i.e., the
point will be plotted with an error bar at (x, y+-dy). This is the usual
file type for error bars.
xydxdx ... Multiple xy data sets composed of X Y DX1 DX2 one point
per line, data sets separated by '&' or some other non-digit character.
DX1 and DX2 are the values of the error bars to be draw to the right and
left of X respectively (assuming DX1 and DX2 are positive), i.e., the
point will be plotted with error bars at (x+dx1, y) and (x-dx2, y).
xydydy ... Multiple xy data sets composed of X Y DY1 DY2 one point
per line, data sets separated by '&' or some other non-digit character.
DY1 and DY2 are the values of the error bars to be draw to the on the top
and bottom of Y respectively (assuming DY1 and DY2 are positive), i.e.,
the point will be plotted with error bars at (x, y+dy1) and (x, y-dy2).
xydxdy ... Multiple xy data sets composed of X Y DX DY one point per
y+dy) and (x-dx, y-dy).
For the xy, xydx, xydy, xydxdx, xydydy, xydxdy data file formats, sets
are separated by a line containing non-numeric characters, that are
neither comment lines (lines with a '#' in column 1) nor parameter lines
(lines beginning with an '@'). Data files can have imbedded comments by
placing a '#' in the first column of the comment line. Plot parameters
can be set by placing a '@' in the first column of the line followed
immediately by the parameter name and setting as described in the format
for parameter files. Comment lines and parameter lines can occur at any
place in the data file, and are not used to indicate data set separators.
I recommend a single '&' on a line to use as a data set separator.
Block data file format.
Block data files are composed of equal length columns. For example:
1 2 3
4 5 6
7 8 9
is a block data file consisting of 3 columns. Each row is assumed to have
the same number of entries.
Hot keys:
When the mouse is on the canvas (where the graph is drawn), there are
some shortcuts that can be taken to bring up several popups or perform
certain operations. They are:
^A - autoscale plot
^B - draw a box (using the current settings for boxes)
^C - bring up the transformations popup
^D - delete an object (string, line, or box)
^E - bring up the edit points popup
^F - bring up the files popup
^G - bring up the define world/view popup
^L - locate the legend
^N - move an object (string, line, or box)
^P - draw a line (using the current settings for lines)
^R - bring up the files popup
^S - setops popup
^T - tics popup
^V - set the viewport with the mouse
^W - write a string (using the current settings for strings)
^X - exit ACE/gr
^Z - enable zoom
NOTE:
The following examples use xmgr, xvgr will provide similar results.
o Read a single data file, autoscale axes, and use default settings:
unix% xmgr test.dat
o Read a single data file and use plot parameters previously saved in
the file "test.par":
unix% xmgr test.dat -param test.par
or
unix% xmgr test.dat -p test.par
o Read a data file and use plot parameters previously saved in the file
"test.par", read the output resulting from the execution of the program
"myprog test.dat":
unix% xmgr test.dat -pipe test.par -source pipe "myprog test.dat"
o Read data from a pipe (the '-source pipe' as the last command line
parameter tells xmgr to read from STDIN), use parameter file "test2.par",
use device 7 to use as the hardcopy device, and ( -h ) don"t run
interactive - just print and quit.
unix% awk "{print $4, $3}" mydata.dat | xmgr -device 2 -param test2.par
-source stdin
o Read data from a pipe (in this case a program running on a
hypercube), use parameter file "test2.par". The data will be X1, Y1, Y2,
..., Yn, (from the -nxy). Override the settings in the parameter file for
the Y-axis and autoscale (the -autoscale), set the type of plot to
linear-log (the -log y).
unix% xmgr -param test2.par -nxy -source pipe "rsh ipsc2.oacis.org gdata"
-autoscale y -log y
AUTHOR
Paul Turner, Oregon Graduate Institute. pturner@amb4.ccalmr.ogi.edu.
BUGS
There is no way to abort a plot.