grace - command line interface
Contents
Bugs
The best way to submit a bug report is using the "Help/Comments" menu entry. Alternatively, see the home
page.
Copyright
Copyright (c) 1991-1995 Paul J Turner, Portland, OR
Copyright (c) 1996-2007 Grace Development Team
Description
Grace is a WYSIWYG tool to make two-dimensional plots of scientific data.
Environment
GRACE_HOME
Specifies the directory where the Grace docs and libs are stored. Default is /usr/local/graceGRACE_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. Default is
mozilla%sGRACE_EDITOR
Specifies the editor which is used to edit sets. Default is xterm-eviGRACE_PRINT_CMD
The print command.
GRACE_FFTW_RAM_WISDOM
and GRACE_FFTW_WISDOM_FILE A flag (0 or 1) and a file name which determine whether a FFT should
use `wisdom' when using the FFTW libraries.
Files
In many cases, when Grace needs to access a file given with a relative pathname, it searches for the file
along the following path:
./pathname:./.grace/pathname:~/.grace/pathname:$GRACE_HOME/pathname
The following files are of a special importance:
gracerc - init file loaded upon start up.
templates/Default.agr - the default template, loaded whenever a new project is started.
fonts/FontDataBase - the file responsible for font configuration.
Home Page
License
The program is distributed under the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2 of the License, or (at your option) any later version.
Jan 28, 2007 GRACE(1)
Name
grace - command line interface
xmgrace - full-featured GUI mode
gracebat - batch mode - print and exit
Options
-autoscalex|y|xy|none
Set autoscale type
-barebones
Turn off all toolbars
-batchfile
Execute batch file on start up (i.e., after all other options have been processed and the UI
initialized)
-blockfile
Assume the data file is block data
-bxyx:y:etc.
Form a set from the current block data set using the current set type from columns given in the
argument
-datehintiso|european|us|days|seconds|nohint
Set the hint for dates analysis
-dpipedescriptor
Read data from descriptor on startup
-fixedwidthheight
Set canvas size fixed to width*height
-free Use free page layout
-graphnumber
Set the current graph number
-graphtypexy|chart|fixed|polar|pie
Set the type of the current graph
-hardcopy
No interactive session, just print and quit
-hdevicedevice_name
Set default hardcopy device. See xmgrace-version for a list of supported devices.
-install
Install private colormap
-legendload
Turn the graph legend on
-logx|y|xy
Set the axis scaling of the current graph to logarithmic
-maxpathlength
Set the maximal drawing path length
-mono Run grace in monochrome mode (affects the display only)
-netcdffile
Assume data file is in netCDF format. This option is present only if the netCDF support was
compiled in
-netcdfxyX_varY_var
If -netcdf was used previously, read from the netCDF file X_var and Y_var variables and create a
set. If X_var is "null" then load the index of Y to X. This option is present only if the netCDF
support was compiled in
-noask Assume the answer is yes to all requests, if the operation would overwrite a file, 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
-npipefile
Read data from named pipe on startup
-nxyfile
Assume data file is in X Y1 Y2 Y3 ... format
-paramfile
Load parameters from file to the current graph
-pexecstring
Interpret string as a parameter setting
-pipe Read data from stdin on startup
-printfilefile
Save print output to file-remove
Remove data file(s) after read
-resultsfile
Write results of some data manipulations to file-rvideo
Exchange the color indices for black and white
-safe Run in the safe mode (default)
-saveallfile
Save all to file-seedvalue
Integer seed for random number generator
-settypexy|xydx|...
Set the type of the next data file
-sourcedisk|pipe
Source type of next data file
-timerdelay
Set allowed time slice for real time inputs to delay ms
-timestamp
Add timestamp to plot
-version
Show the program version, registered devices and build time configuration information.
[DEBIAN] Direct PDF output has been disabled since the PDF library is not free software. There is
an easy workaround - just use the epstopdf script from the texlive-font-utils package.
-viewportxminyminxmaxymax
Set the viewport for the current graph
-wdpath
Set the working directory
-worldxminyminxmaxymax
Set the world coordinates for the current graph
-usage|-help
This message
Resources
When run in the GUI mode, the interface is a subject to X resource settings.
Please refer to the User's Guide for a list of important ones.
See Also
grconvert(1), X(1) [or Xorg(1)], Grace User's Guide
Synopsis
grace [ option | filename ]...
xmgrace [ option | filename ]...
gracebat [ option | filename ]...
