--- name: "grace" section: "1" platform: "linux" package: "grace" version: "1:5.1.25-18" release: "Debian 13 (Trixie)" platforms: ["linux"] url: "https://new.carta.tech/grace" --- # grace(1) command line interface xmgrace - full-featured GUI mode gracebat - batch mode - print and exit ## NAME grace - command line interface\ xmgrace - full-featured GUI mode\ gracebat - batch mode - print and exit ## 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* Execute batch *file* on start up (i.e., after all other options have been processed and the UI initialized) - **-block** *file* Assume the data *file* is block data - **-bxy** *x:y:etc.* Form a set from the current block data set using the current set type from columns given in 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** *xy\|chart\|fixed\|polar\|pie* Set the type of the current graph - **-hardcopy** No interactive session, just print and quit - **-hdevice** *device\_name* Set default hardcopy device. See **xmgrace -version** for a list of supported devices. - **-install** Install private colormap - **-legend load** Turn the graph legend on - **-log** *x\|y\|xy* Set the axis scaling of the current graph to logarithmic - **-maxpath** *length* Set the maximal drawing path length - **-mono** Run grace in monochrome mode (affects the display only) - **-netcdf** *file* Assume data file is in netCDF format. This option is present only if the netCDF support was compiled in - **-netcdfxy** *X\_var Y\_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 - **-npipe** *file* Read data from named pipe on startup - **-nxy** *file* Assume data file is in X Y1 Y2 Y3 ... format - **-param** *file* Load parameters from *file* to the current graph - **-pexec** *string* Interpret string as a parameter setting - **-pipe** Read data from stdin on startup - **-printfile** *file* Save print output to *file* - **-remove** Remove data file(s) after read - **-results** *file* Write results of some data manipulations to *file* - **-rvideo** Exchange the color indices for black and white - **-safe** Run in the safe mode (default) - **-saveall** *file* Save all to *file* - **-seed** *value* Integer seed for random number generator - **-settype** *xy\|xydx\|...* Set the type of the next data file - **-source** *disk\|pipe* Source type of next data file - **-timer** *delay* 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. - **-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 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. ## 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. Default is **mozilla %s** - **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 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. ## SEE ALSO [grconvert(1)](/grconvert/1.md), X(1) \[or [Xorg(1)](/Xorg/1.md)\], 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 entry. Alternatively, see the home page. ## AUTHORS **Grace** is derived from **ACE/gr** (a.k.a **Xmgr** ) written by Paul J Turner. From version 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-2007 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 2 of the License, or (at your option) any later version.