Delete current history, conf, cpt, or the cache, data or sessions directories


gmt clear [all |cache |conf |cpt |data |history |sessions ] [ -V[level] ] [ –PAR=value ]

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


The clear command allows users to delete their current history, conf, or cpt file, remove the entire user cache, data, or sessions directory, or all of the above.

Optional Arguments

Deletes all the items under the control of the individual targets.
Delete the current gmt.conf file used for the modern session.
Delete the current (and hidden) cpt in effect (if any) for the modern session.
Delete the user’s cache directory and its contents.
Delete the user’s data download directory and its contents.
Deletes the current gmt.history file for the modern session.
Delete the user’s sessions directory.
-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 remove the current CPT file that was created by grdimage in an earlier command, use

gmt clear cpt

To completely wipe your GMT cache directory, try

gmt clear cache

See Also

begin, docs, end, figure, subplot, gmt