.. index:: ! gmt *** gmt *** .. only:: not man gmt - The Generic Mapping Tools data processing and display software package Introduction ------------ GMT is a collection of public-domain Unix tools that allows you to manipulate x,y and x,y,z data sets (filtering, trend fitting, gridding, projecting, etc.) and produce PostScript illustrations ranging from simple x-y plots, via contour maps, to artificially illuminated surfaces and 3-D perspective views in black/white or full color. Linear, log10, and power scaling is supported in addition to over 30 common map projections. The processing and display routines within GMT are completely general and will handle any (x,y) or (x,y,z) data as input. Synopsis -------- **gmt** is the main program that can start any of the modules: **gmt** module module-options where module is the name of a GMT module and the options are those that pertain to that particular module. A few special modules are also available: **gmt clear** *items* while delete the user's history. Choose between *history* (deletes the gmt.history file in the current directory), *conf* (deletes the gmt.conf file in the current directory), *cache* (deletes the user's cache directory and all of its content), or *all* (does all of the above). If no module is given then several other options are available: **-**\ **-help** List and description of GMT modules. **-**\ **-show-cores** Show number of available cores. **-**\ **-show-bindir** Show directory of executables and exit. **-**\ **-show-datadir** Show data directory/ies and exit. **-**\ **-show-modules** List module names on stdout and exit. **-**\ **-show-plugindir** Show plugin directory and exit. **-**\ **-show-sharedir** Show share directory and exit. **-**\ **-version** Print version and exit. **=** Check if that module exist and if so the program will exit with status of 0; otherwise the status of exit will be non-zero. Command-line completion ----------------------- GMT provides basic command-line completion (tab completion) for bash. The completion rules are either installed in ``/etc/bash_completion.d/gmt`` or ``/share/tools/gmt_completion.bash``. Depending on the distribution, you may still need to source the gmt completion file from ``~/.bash_completion`` or ``~/.bashrc``. For more information see Section :ref:`command-line-completion` in the CookBook. GMT Overview ------------ The following is a summary of all the programs supplied with GMT and a very short description of their purpose. Detailed information about each program can be found in the separate manual pages. .. include:: explain_gmt_modules.rst_ Custom Modules -------------- The **gmt** program can also load custom modules from shared libraries built as specified in the GMT API documentation. This way your modules can benefit form the GMT infrastructure and extend GMT in specific ways. The Common GMT Options ---------------------- .. include:: common_SYN_OPTs.rst_ |SYN_OPT-B| **-J**\ *parameters* **-Jz**\ \|\ **Z**\ *parameters* **-K** **-O** **-P** |SYN_OPT-Rz| |SYN_OPT-U| |SYN_OPT-V| |SYN_OPT-X| |SYN_OPT-Y| |SYN_OPT-a| |SYN_OPT-b| |SYN_OPT-d| |SYN_OPT-f| |SYN_OPT-g| |SYN_OPT-h| |SYN_OPT-i| |SYN_OPT-n| |SYN_OPT-o| |SYN_OPT-p| **-r** |SYN_OPT-s| |SYN_OPT-t| |SYN_OPT-x| |SYN_OPT-:| Description ----------- These are all the common GMT options that remain the same for all GMT programs. No space between the option flag and the associated arguments. .. include:: explain_-B_full.rst_ .. include:: explain_-J_full.rst_ .. include:: explain_-Jz_full.rst_ .. include:: explain_-K_full.rst_ .. include:: explain_-O_full.rst_ .. include:: explain_-P_full.rst_ .. include:: explain_-R_full.rst_ .. include:: explain_-Rz_full.rst_ .. include:: explain_-U_full.rst_ .. include:: explain_-V_full.rst_ .. include:: explain_-XY_full.rst_ .. include:: explain_-aspatial_full.rst_ .. |Add_-bi| unicode:: 0x20 .. just an invisible code .. include:: explain_-bi_full.rst_ .. include:: explain_-bo_full.rst_ .. |Add_-d| unicode:: 0x20 .. just an invisible code .. include:: explain_-d_full.rst_ .. |Add_-di| unicode:: 0x20 .. just an invisible code .. include:: explain_-di_full.rst_ .. |Add_-do| unicode:: 0x20 .. just an invisible code .. include:: explain_-do_full.rst_ .. |Add_-e| unicode:: 0x20 .. just an invisible code .. include:: explain_-e_full.rst_ .. |Add_-f| unicode:: 0x20 .. just an invisible code .. include:: explain_-f_full.rst_ .. |Add_-g| unicode:: 0x20 .. just an invisible code .. include:: explain_-g_full.rst_ .. |Add_-h| unicode:: 0x20 .. just an invisible code .. include:: explain_-h_full.rst_ .. include:: explain_-icols_full.rst_ .. include:: explain_-n_full.rst_ .. include:: explain_-ocols_full.rst_ .. include:: explain_perspective_full.rst_ .. include:: explain_nodereg_full.rst_ .. include:: explain_-s_full.rst_ .. include:: explain_-t_full.rst_ .. include:: explain_core_full.rst_ .. include:: explain_colon_full.rst_ .. include:: explain_help.rst_ .. include:: explain_color.rst_ .. include:: explain_fill.rst_ .. include:: explain_font.rst_ .. include:: explain_pen.rst_ .. include:: explain_precision.rst_ .. include:: explain_grd_inout.rst_ See Also -------- Look up the individual man pages for more details and full syntax. Run ``gmt --help`` to list all GMT programs and to show all installation directories. For an explanation of the various GMT settings in this man page (like :ref:`FORMAT_FLOAT_OUT `), see the man page of the GMT configuration file :doc:`gmt.conf`. Information is also available on the GMT home page http://gmt.soest.hawaii.edu/