GRACE(1) GRACE(1)
NAME
grace - command line interface
xmgrace - full-featured GUI mode
gracebat - batch mode - print and exit(3,n,1 builtins)
DESCRIPTION
Grace is a WYSIWYG tool to make two-dimensional plots of scientific
data.
SYNOPSIS
grace [ option | filename ]...
xmgrace [ option | filename ]...
gracebat [ option | filename ]...
OPTIONS
-autoscale x|y|xy|none
Set autoscale type
-barebones
Turn off all toolbars
-batch file(1,n)
Execute batch file(1,n) on start up
-block file(1,n)
Assume the data file(1,n) is block data
-bxy x:y:etc.
Form a set(7,n,1 builtins) from the current block data set(7,n,1 builtins) using the current set(7,n,1 builtins)
type from columns given in(1,8) the argument
-datehint iso|european|us|days|seconds|nohint
Set the hint for dates analysis
-dpipe descriptor
Read data from descriptor on startup
-fixed width height
Set canvas size fixed to width*height
-free Use free page layout
-graph number
Set the current graph number
-graphtype type
Set the type of the current graph
-hardcopy
No interactive session, just print and quit
-hdevice device_name
Set default hardcopy device
-install
Install private colormap
-legend load(7,n)
Turn the graph legend on
-log x|y|xy
Set the axis scaling of the current graph to logarithmic
-mono Run grace in(1,8) monochrome mode (affects the display only)
-netcdf file(1,n)
Assume data file(1,n) is in(1,8) netCDF format. This option is present
only if(3,n) the netCDF support was compiled in(1,8)
-netcdfxy X_var Y_var
If -netcdf was used previously, read(2,n,1 builtins) from the netCDF file(1,n) X_var
and Y_var variables and create a set. If X_var is "null" then
load(7,n) the index of Y to X. This option is present only if(3,n) the
netCDF support was compiled in(1,8)
-noask Assume the answer is yes to all requests, if(3,n) the operation would
overwrite a file(1,n), grace will do so without prompting
-noinstall
Don't use private colormap
-noprint
In batch mode, do not print
-nosafe
Disable safe mode
-nosigcatch
Don't catch signals
-npipe file(1,n)
Read data from named(5,8) pipe(2,8) on startup
-nxy file(1,n)
Assume data file(1,n) is in(1,8) X Y1 Y2 Y3 ... format
-param file(1,n)
Load parameters from file(1,n) to the current graph
-pexec string(3,n)
Interpret string(3,n) as a parameter setting
-pipe Read data from stdin on startup
-printfile file(1,n)
Save print output to file(1,n)
-remove
Remove data file(1,n)(s) after read(2,n,1 builtins)
-results file(1,n)
Write results of some data manipulations to file(1,n)
-rvideo
Exchange the color indices for black and white
-safe Run in(1,8) the safe mode (default)
-saveall file(1,n)
Save all to file(1,n)
-seed value
Integer seed for random(3,4,6) number generator
-source disk|pipe(2,8)
Source type of next data file(1,n)
-timer delay
Set allowed time(1,2,n) slice for real time(1,2,n) inputs to delay ms
-timestamp
Add timestamp to plot
-settype xy|xydx|...
Set the type of the next data file(1,n)
-version
Show the program version(1,3,5) and exit(3,n,1 builtins)
-viewport xmin ymin xmax ymax
Set the viewport for the current graph
-wd path
Set the working directory
-world xmin ymin xmax ymax
Set the world coordinates for the current graph
-usage|-help
This message
RESOURCES
When run in(1,8) the GUI mode, the interface is a subject to X resource set-
tings.
Please refer to the User's Guide for a list of important ones.
ENVIRONMENT
GRACE_HOME
Specifies the directory where the Grace docs and libs are
stored. Default is /usr/local/grace
GRACE_HELPVIEWER
The shell command to run an HTML viewer for on-line browsing of
the help documents. Must include at least one instance of "%s"
which will be replaced with the actual URL by Grace.
GRACE_EDITOR
Specifies the editor which is used to edit sets. Default is
xterm -e vi
GRACE_PRINT_CMD
The print command.
GRACE_FFTW_RAM_WISDOM
and GRACE_FFTW_WISDOM_FILE A flag (0 or 1) and a file(1,n) name which
determine whether a FFT should use `wisdom' when using the FFTW
libraries.
FILES
In many cases, when Grace needs to access(2,5) a file(1,n) given with a relative
pathname, it searches for the file(1,n) along the following path:
./pathname:./.grace/pathname:~/.grace/pathname: $GRACE_HOME/pathname
The following files are of a special importance:
gracerc - init file(1,n) loaded upon start up.
templates/Default.agr - the default template, loaded whenever a new
project is started.
fonts/FontDataBase - the file(1,n) responsible for font configuration.
SEE ALSO
grconvert(1), X(1), Grace User's Guide
HOME PAGE
http://plasma-gate.weizmann.ac.il/Grace/
BUGS
The best way to submit a bug report is using the "Help/Comments" menu(3x,n,n tk_menuSetFocus)
entry. Alternatively, see the home page.
AUTHORS
Grace is derived from ACE/gr (a.k.a Xmgr ) written by Paul J Turner.
From version(1,3,5) number 4.00, the development was taken over by a team of
volunteers under the coordination of Evgeny Stambulchik.
COPYRIGHT
Copyright (c) 1991-1995 Paul J Turner, Portland, OR
Copyright (c) 1996-2003 Grace Development Team
LICENSE
The program is distributed under the terms of the GNU General Public
License as published by the Free Software Foundation; either version(1,3,5) 2
of the License, or (at your option) any later version.
Jan 03, 2003 GRACE(1)