Set attributes for the current figure


gmt figure prefix [formats] [options] [ -V[level] ] [ –PAR=value ]

Note: No space is allowed between the option flag and the associated arguments.


A GMT modern session can make any number of illustrations. In this situation, the figure command tells GMT the name and format(s) to use for the current plot. It must be issued before you start plotting to the current figure, and each new call changes focus to the next figure. You may go back and forth between different figure but the optional arguments (formats and options) can only be given the first time to specify a new figure. In addition to prefix and formats, you can supply a comma-separated series of psconvert options that should override the default settings provided via PS_CONVERT. The only other available option controls verbosity.

Required Arguments

Name-stem used to construct final figure names, Extensions are appended automatically from your formats selection.

Optional Arguments

Give one or more comma-separated graphics extensions from the allowable graphics formats [pdf].
Sets one or more comma-separated options arguments that will be passed to psconvert when preparing this figure [A]. The valid subset of options are A[args],Cargs,Ddir,Edpi,Hfactor, Margs,Qargs,S. See the psconvert documentation for details on these options.
-V[level] (more ...)
Select verbosity level [c].
-^ or just -
Print a short message about the syntax of the command, then exits (NOTE: on Windows just use -).
-+ or just +
Print an extensive usage (help) message, including the explanation of any module-specific option (but not the GMT common options), then exits.
-? or no arguments
Print a complete usage (help) message, including the explanation of all options, then exits.
Temporarily override a GMT default setting; repeatable. See gmt.conf for parameters.


To start a new figure in your session by the name Regional, and request we make both a PDF and and EPS file, try

gmt figure Regional pdf,eps

To start a new figure GlobalMap that should be returned as a JPEG file with a 1 cm padding around the image, try

gmt figure GlobalMap jpg A1c

See Also

begin, clear, docs, end, subplot, gmt