figure

Set attributes for the current figure

Synopsis

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

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

Description

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 terminates the previous figure and changes focus to the next 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

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

Optional Arguments

formats
Give one or more comma-separated graphics extensions from the allowable graphics formats [pdf].
options
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.
–PAR=value
Temporarily override a GMT default setting; repeatable. See gmt.conf for parameters.

Examples

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, tr¥

gmt figure GlobalMap jpg A1c

See Also

begin, clear, end, subplot, gmt