Initiate a new GMT session using modern mode


gmt begin [prefix] [formats] [ -V[level] ]

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


The begin tells GMT to begin a new modern session. If your script only makes a single plot then this is the most straightforward way to specify the name and format(s) of your plots. However, if multiple illustrations will be made then you will need to use figure as well.

Optional Arguments

Name-stem used to construct the single final figure name. Extensions are appended automatically from your formats selection [gmtsession].
Give one or more comma-separated graphics extensions from the allowable graphics formats [pdf].
-V[level] (more ...)
Select verbosity level [c].
Format Explanation
bmp MicroSoft BitMap.
eps Encapsulated PostScript
jpg Joint Photographic Experts Group format
pdf Portable Document Format [Default]
png Portable Network Graphics (opaque)
PNG Portable Network Graphics (transparent)
ppm Portable Pixel Map
ps Plain PostScript
tif Tagged Image Format File


To initiate a new modern session that should produce a single map we called Figure_2, and we would like both a PDF and a PNG raster image, we would run

gmt begin Figure_2 pdf,png

If the modern session is only used for computations and no illustration is made then we do not need to give any arguments

gmt begin

Should we give such a command and still produce a plot then it will automatically be called gmtsession.pdf.

See Also

clear, end, figure, subplot, gmt