1GRACE(1)                    General Commands Manual                   GRACE(1)
2
3
4

NAME

6       grace - command line interface
7       xmgrace - full-featured GUI mode
8       gracebat - batch mode - print and exit
9
10

DESCRIPTION

12       Grace  is  a  WYSIWYG  tool to make two-dimensional plots of scientific
13       data.
14
15

SYNOPSIS

17       grace [ option | filename ]...
18       xmgrace [ option | filename ]...
19       gracebat [ option | filename ]...
20
21

OPTIONS

23       -autoscale x|y|xy|none
24              Set autoscale type
25
26       -barebones
27              Turn off all toolbars
28
29       -batch file
30              Execute batch file on start up (i.e., after  all  other  options
31              have been processed and the UI initialized)
32
33       -block file
34              Assume the data file is block data
35
36       -bxy x:y:etc.
37              Form a set from the current block data set using the current set
38              type from columns given in the argument
39
40       -datehint iso|european|us|days|seconds|nohint
41              Set the hint for dates analysis
42
43       -dpipe descriptor
44              Read data from descriptor on startup
45
46       -fixed width height
47              Set canvas size fixed to width*height
48
49       -free  Use free page layout
50
51       -graph number
52              Set the current graph number
53
54       -graphtype xy|chart|fixed|polar|pie
55              Set the type of the current graph
56
57       -hardcopy
58              No interactive session, just print and quit
59
60       -hdevice device_name
61              Set default hardcopy device. See xmgrace -version for a list  of
62              supported devices.
63
64       -install
65              Install private colormap
66
67       -legend load
68              Turn the graph legend on
69
70       -log x|y|xy
71              Set the axis scaling of the current graph to logarithmic
72
73       -maxpath length
74              Set the maximal drawing path length
75
76       -mono  Run grace in monochrome mode (affects the display only)
77
78       -netcdf file
79              Assume  data  file  is  in netCDF format. This option is present
80              only if the netCDF support was compiled in
81
82       -netcdfxy X_var Y_var
83              If -netcdf was used previously, read from the netCDF file  X_var
84              and  Y_var  variables and create a set.  If X_var is "null" then
85              load the index of Y to X.  This option is present  only  if  the
86              netCDF support was compiled in
87
88       -noask Assume the answer is yes to all requests, if the operation would
89              overwrite a file, grace will do so without prompting
90
91       -noinstall
92              Don't use private colormap
93
94       -noprint
95              In batch mode, do not print
96
97       -nosafe
98              Disable safe mode
99
100       -nosigcatch
101              Don't catch signals
102
103       -npipe file
104              Read data from named pipe on startup
105
106       -nxy file
107              Assume data file is in X Y1 Y2 Y3 ...  format
108
109       -param file
110              Load parameters from file to the current graph
111
112       -pexec string
113              Interpret string as a parameter setting
114
115       -pipe  Read data from stdin on startup
116
117       -printfile file
118              Save print output to file
119
120       -remove
121              Remove data file(s) after read
122
123       -results file
124              Write results of some data manipulations to file
125
126       -rvideo
127              Exchange the color indices for black and white
128
129       -safe  Run in the safe mode (default)
130
131       -saveall file
132              Save all to file
133
134       -seed value
135              Integer seed for random number generator
136
137       -settype xy|xydx|...
138              Set the type of the next data file
139
140       -source disk|pipe
141              Source type of next data file
142
143       -timer delay
144              Set allowed time slice for real time inputs to delay ms
145
146       -timestamp
147              Add timestamp to plot
148
149       -version
150              Show the program version, registered devices and build time con‐
151              figuration information.
152
153       -viewport xmin ymin xmax ymax
154              Set the viewport for the current graph
155
156       -wd path
157              Set the working directory
158
159       -world xmin ymin xmax ymax
160              Set the world coordinates for the current graph
161
162       -usage|-help
163              This message
164
165

RESOURCES

167       When run in the GUI mode, the interface is a subject to X resource set‐
168       tings.
169              Please refer to the User's Guide for a list of important ones.
170
171

ENVIRONMENT

173       GRACE_HOME
174              Specifies the directory  where  the  Grace  docs  and  libs  are
175              stored. Default is /usr/local/grace
176
177       GRACE_HELPVIEWER
178              The  shell command to run an HTML viewer for on-line browsing of
179              the help documents. Must include at least one instance  of  "%s"
180              which  will be replaced with the actual URL by Grace. Default is
181              mozilla %s
182
183       GRACE_EDITOR
184              Specifies the editor which is used  to  edit  sets.  Default  is
185              xterm -e vi
186
187       GRACE_PRINT_CMD
188              The print command.
189
190       GRACE_FFTW_RAM_WISDOM
191              and GRACE_FFTW_WISDOM_FILE A flag (0 or 1) and a file name which
192              determine whether a FFT should use `wisdom' when using the  FFTW
193              libraries.
194
195

FILES

197       In  many cases, when Grace needs to access a file given with a relative
198       pathname, it searches for the file along the following path:
199        ./pathname:./.grace/pathname:~/.grace/pathname:$GRACE_HOME/pathname
200
201       The following files are of a special importance:
202
203       gracerc - init file loaded upon start up.
204
205       templates/Default.agr - the default template,  loaded  whenever  a  new
206       project is started.
207
208       fonts/FontDataBase - the file responsible for font configuration.
209
210

SEE ALSO

212       grconvert(1), X(1) [or Xorg(1)], Grace User's Guide
213
214

HOME PAGE

216       http://plasma-gate.weizmann.ac.il/Grace/
217
218

BUGS

220       The  best  way to submit a bug report is using the "Help/Comments" menu
221       entry.  Alternatively, see the home page.
222
223

AUTHORS

225       Grace is derived from ACE/gr (a.k.a Xmgr ) written by  Paul  J  Turner.
226       From  version  number 4.00, the development was taken over by a team of
227       volunteers under the coordination of Evgeny Stambulchik.
228
229
231       Copyright (c) 1991-1995 Paul J Turner, Portland, OR
232       Copyright (c) 1996-2007 Grace Development Team
233
234

LICENSE

236       The program is distributed under the terms of the  GNU  General  Public
237       License  as published by the Free Software Foundation; either version 2
238       of the License, or (at your option) any later version.
239
240
241
242                                 Jan 28, 2007                         GRACE(1)
Impressum