Package GMT-common

Common files for GMT

http://gmt.soest.hawaii.edu/

The GMT-common package contains common files for GMT (Generic
Mapping Tools) package.

General Commands (Section 1)
backtracker
backtracker reads (longitude, latitude, age) positions from infiles [or standard input] and computes rotated (x,y,t) coordinates using the specified rotation...
blockmean
blockmean reads arbitrarily located (x,y,z) triples [or optionally weighted quadruples (x,y,z,w)] from standard input [or table] and writes to standard output a...
blockmedian
blockmedian reads arbitrarily located (x,y,z) triples [or optionally weighted quadruples (x,y,z,w)] from standard input [or table] and writes to standard output...
blockmode
blockmode reads arbitrarily located (x,y,z) triples [or optionally weighted quadruples (x,y,z,w)] from standard input [or table] and writes to standard output...
dimfilter
dimfilter will filter a .nc file in the space (or time) domain by dividing the given filter circle into n_sectors, applying one of the selected primary...
filter1d
filter1d is a general time domain filter for multiple column time series data. The user specifies which column is the time (i.e., the independent variable)...
fitcircle
fitcircle reads lon,lat [or lat,lon] values from the first two columns on standard input [or table]. These are converted to Cartesian three-vectors on the unit...
gmt
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.
gmt2kml
gmt2kml reads one or more GMT table file and converts them to a single output file using Google Earth's KML format. Data may represent points, lines, or...
gmt5syntax
gmt5syntax is a perl script that converts old-style GMT commands in, e.g., shell scripts, to the new gmt <module>-syntax. This utility is located in the tools...
gmtconnect
gmtconnect reads standard input or one or more data files, which may be multisegment files, and examines the coordinates of the end points of all line segments...
gmtconvert
gmtconvert reads its standard input [or input files] and writes out the desired information to standard output. It can do a combination of nine tasks: (1)...
gmtdefaults
gmtdefaults lists the GMT parameter defaults if the option -D is used. There are three ways to change some of the settings: (1) Use the command gmtset, (2) use...
gmtflexure
gmtflexure computes the flexural response to 2-D loads using a range of user-selectable options, such as boundary conditions, pre-existing deformations...
gmtget
gmtget will list the value of one or more GMT default parameters.
gmtgravmag3d
gmtgravmag3d will compute the gravity or magnetic anomaly of a body described by a set of triangles. The output can either be along a given set of xy locations...
gmtinfo
gmtinfo reads its standard input [or from files] and finds the extreme values in each of the columns. It recognizes NaNs and will print warnings if the number...
gmtlogo
This module plots the GMT logo on a map. By default, the GMT logo is 2 inches wide and 1 inch high and will be positioned relative to the current plot origin...
gmtmath
gmtmath will perform operations like add, subtract, multiply, and divide on one or more table data files or constants using Reverse Polish Notation (RPN) syntax...
gmtpmodeler
gmtpmodeler reads a table with lon, lat and optionally age triplets and a plate motion model and evaluates one of several model predictions. Optionally, the...
gmtregress
gmtregress reads one or more data tables [or stdin] and determines the best linear regression model y = a + b* x for each segment using the chosen parameters...
gmtselect
gmtselect is a filter that reads (longitude, latitude) positions from the first 2 columns of infiles [or standard input] and uses a combination of 1-7 criteria...
gmtset
gmtset will adjust individual GMT defaults settings in the current directory's gmt.conf file. If no such file exists one will be created. The main purpose of...
gmt_shell_functions.sh
gmt_shell_functions.sh provides a set of functions to Bourne (again) shell scripts in support of GMT. The calling shell script should include the following...
gmtsimplify
gmtsimplify reads one or more data files and apply the Douglas-Peucker line simplification algorithm. The method recursively subdivides a polygon until a run of...
gmtspatial
gmtspatial reads one or more data files (which may be multisegment files) that contains closed polygons and operates of these polygons in the specified way...
gmtswitch
gmtswitch helps you modify your environment to allow for the switching back and forth between several installed GMT versions, in particular GMT 5 and versions...
gmtvector
gmtvector reads either (x, y), (x, y, z), (r, theta) or (lon, lat) [or (lat,lon); see -:] coordinates from the first 2-3 columns on standard input [or one or...
gmtwhich
gmtwhich reports the full paths to the files given on the command line. We look for the file in (1) the current directory, (2) in $GMT_USERDIR (if defined), (3)...
gpsgridder
gpsgridder grids 2-D vector data such as GPS velocities by using a coupled model based on 2-D elasticity. The degree of coupling can be tuned by adjusting the...
gravfft
gravfft can be used into three main modes. Mode 1: Simply compute the geopotential due to the surface given in the topo.grd file. Requires a density contrast...
grd2cpt
grd2cpt reads one or more grid files and writes a static color palette (CPT) file to standard output. The CPT is based on an existing dynamic master CPT of your...
grd2rgb
grd2rgb reads one of three types of input files: (1) A Sun 8-, 24-, or 32-bit raster file; we the write out the red, green, and blue components (0-255 range) to...
grd2xyz
grd2xyz reads one or more binary 2-D grid files and writes out xyz-triplets in ASCII [or binary] format to standard output. Modify the precision of the ASCII...
grdblend
grdblend reads a listing of grid files and blend parameters and creates a binary grid file by blending the other grids using cosine-taper weights. grdblend will...
grdclip
grdclip will set values < low to below and/or values > high to above. You can also specify one or more intervals where all values should be set to IT(between)...
grdcontour
grdcontour reads a 2-D grid file and produces a contour map by tracing each contour through the grid. PostScript code is generated and sent to standard output...
grdconvert
grdconvert reads a grid file in one format and writes it out using another format. As an option the user may select a subset of the data to be written and to...
grdcut
grdcut will produce a new outgrid file which is a subregion of ingrid. The subregion is specified with -R as in other programs; the specified range must not...
grdedit
grdedit reads the header information in a binary 2-D grid file and replaces the information with values provided on the command line [if any]. As an option...
grdfft
grdfft will take the 2-D forward Fast Fourier Transform and perform one or more mathematical operations in the frequency domain before transforming back to the...
grdfilter
grdfilter will filter a grid file in the time domain using one of the selected convolution or non-convolution isotropic or rectangular filters and compute...
grdflexure
grdflexure computes the flexural response to loads using a range of user-selectable rheologies. User may select from elastic, viscoelastic, or firmoviscous...
grdgradient
grdgradient may be used to compute the directional derivative in a given direction (-A), or the direction (-S) [and the magnitude (-D)] of the vector gradient...
grdgravmag3d
grdgravmag3d will compute the gravity anomaly of a body described by one or (optionally) two grids The output can either be along a given set of xy locations or...
grdhisteq
grdhisteq allows the user to find the data values which divide a given grid file into patches of equal area. One common use of grdhisteq is in a kind of...
grdimage
grdimage reads one 2-D grid file and produces a gray-shaded (or colored) map by plotting rectangles centered on each grid node and assigning them a gray-shade...
grdinfo
grdinfo reads a 2-D binary grid file and reports metadata and various statistics for the (x,y,z) data in the grid file(s). The output information contains the...
grdlandmask
grdlandmask reads the selected shoreline database and uses that information to decide which nodes in the specified grid are over land or over water. The nodes...
grdmask
grdmask can operate in two different modes. 1. It reads one or more pathfiles that each define a closed polygon. The nodes defined by the specified region and...
grdmath
grdmath will perform operations like add, subtract, multiply, and divide on one or more grid files or constants using Reverse Polish Notation (RPN) syntax...
grdpaste
grdpaste will combine file_a.nc and file_b.nc into outfile.nc by pasting them together along their common edge. Files file_a.nc and file_b.nc must have the same...
grdpmodeler
grdpmodeler reads a geographical age grid and a plate motion model and evaluates one of several model predictions. Optionally, the user may supply a clipping...
grdproject
grdproject will do one of two things depending whether -I has been set. If set, it will transform a gridded data set from a rectangular coordinate system onto a...
grdraster
grdraster reads a file called grdraster.info from the current working directory, the directories pointed to by the environment variables $GMT_USERDIR and...
grdredpol
grdredpol will take a .nc file with a magnetic anomaly and compute the reduction to the pole (RTP) anomaly. This anomaly is the one that would have been produce...
grdrotater
grdrotater reads a geographical grid and reconstructs it given total reconstruction rotations. Optionally, the user may supply a clipping polygon in...
grdsample
grdsample reads a grid file and interpolates it to create a new grid file with either: a different registration (-r or -T); or, a new grid-spacing or number of...
grdseamount
grdseamount will compute the combined shape of multiple synthetic seamounts given their individual shape parameters. We read a list with seamount locations and...
grdspotter
grdspotter reads a grid file with residual bathymetry or gravity and calculates flowlines from each node that exceeds a minimum value using the specified...
grdtrack
grdtrack reads one or more grid files (or a Sandwell/Smith IMG files) and a table (from file or standard input; but see -E for exception) with (x,y) [or...
grdtrend
grdtrend reads a 2-D grid file and fits a low-order polynomial trend to these data by [optionally weighted] least-squares.
grdvector
grdvector reads two 2-D grid files which represents the x- and y-components of a vector field and produces a vector field plot by drawing vectors with...
grdview
grdview reads a 2-D grid file and produces a 3-D perspective plot by drawing a mesh, painting a colored/grayshaded surface made up of polygons, or by scanline...
grdvolume
grdvolume reads a 2-D grid file and calculates the volume contained between the surface and the plane specified by the given contour (or zero if not given) and...
greenspline
greenspline uses the Green's function G(x; x') for the chosen spline and geometry to interpolate data at regular [or arbitrary] output locations...
gshhg
gshhg reads the binary coastline (GSHHG) or political boundary or river (WDBII) files and writes an ASCII (or binary; see -b) listing to standard output. It...
hotspotter
hotspotter reads (longitude, latitude, amplitude, radius, age) records from tables [or standard input] and calculates flowlines using the specified stage or...
img2grd
img2grd reads an img format file, extracts a subset, and writes it to a grid file. The -M option dictates whether or not the Spherical Mercator projection of...
isogmt
isogmt runs a single GMT command or shell script in isolation mode. This means that the files gmt.history and gmt.conf will be read from the usual locations...
kml2gmt
kml2gmt reads a Google Earth KML file and outputs a GMT table file. Only KML files that contain points, lines, or polygons can be processed. This is a...
makecpt
makecpt is a utility that will help you make static color palette tables (CPTs). You define an equidistant set of contour intervals or pass your own z-table or...
mapproject
mapproject reads (longitude, latitude) positions from tables [or standard input] and computes (x,y) coordinates using the specified map projection and scales...
mgd77convert
mgd77convert reads versions of MGD77 files and writes the same data in (probably) another format to a new file in the current directory. Both pre- and post-Y2K...
mgd77info
mgd77info reads <legid>.[mgd77|nc] files and produces a single record of information about each cruise specified. The information includes beginning and end...
mgd77list
mgd77list reads <NGDC-id>.[mgd77|nc] files and produces an ASCII [or binary] table. The <NGDC-id>.[mgd77|nc] files contain track information such as leg-id...
mgd77magref
mgd77magref will evaluate the IGRF or the CM4 geomagnetic models at the specified locations and times.
mgd77manage
mgd77manage deals with maintaining extra custom columns in MGD77+ netCDF files. You can either delete one or more columns, add a new column, update an existing...
mgd77path
mgd77path returns the full pathname to one or more MGD77 files. The pathname returned for a given cruise may change with time due to reshuffling of...
mgd77sniffer
mgd77sniffer scans old (pre-Y2K) and new format ASCII MGD77 files for errors using point-by-point sanity checking, along-track detection of excessive slopes...
mgd77track
mgd77track reads NGDC MGD77 cruises and creates PostScript code that will plot one or more ship tracks on a map using the specified projection. The PostScript...
nearneighbor
nearneighbor reads arbitrarily located (x,y,z[,w]) triples [quadruplets] from standard input [or table] and uses a nearest neighbor algorithm to assign an...
originator
originator reads (longitude, latitude, height, radius, crustal_age) records from tables [or standard input] and uses the given Absolute Plate Motion (APM) stage...
project
project reads arbitrary (x, y[,z]) data from standard input [or table ] and writes to standard output any combination of (x, y, z, p, q, r, s), where (p, q) are...
psbasemap
psbasemap creates PostScript code that will produce a basemap. Several map projections are available, and the user may specify separate tick-mark intervals for...
psclip
psclip reads (x,y) file(s) [or standard input] and draws polygons that are activated as clipping paths. Several files may be read to create complex paths...
pscoast
pscoast plots grayshaded, colored, or textured land-masses [or water-masses] on maps and [optionally] draws coastlines, rivers, and political boundaries...
pscontour
pscontour reads an ASCII [or binary] table and produces a raw contour plot by triangulation. By default, the optimal Delaunay triangulation is performed (using...
psconvert
psconvert converts one or more PostScript files to other formats (BMP, EPS, JPEG, PDF, PNG, PPM, SVG, TIFF) using GhostScript. Input file names are read from...
pscoupe
pscoupe reads data values from files [or standard input] and generates PostScript code that will plot symbols, lines or polygons on a cross-section. Focal...
pshistogram
pshistogram reads file [or standard input] and examines the first data column (or use -i) to calculate histogram parameters based on the bin-width provided...
psimage
psimage reads an Encapsulated PostScript file or a raster image file and plots it on a map. The image can be scaled arbitrarily, and 1-bit raster images can be...
pslegend
pslegend will make legends that can be overlaid on maps. It reads specific legend-related information from an input file [or stdin]. Unless otherwise noted...
psmask
psmask reads a (x,y,z) file [or standard input] and uses this information to find out which grid cells are reliable. Only grid cells which have one or more data...
psmeca
psmeca reads data values from files [or standard input] and generates PostScript code that will plot focal mechanisms on a map. Most options are the same as for...
pspolar
pspolar reads data values from files [or standard input] and generates PostScript code that will plot stations on focal mechanisms on a map. The PostScript code...
psrose
psrose reads (length,azimuth) pairs from file [or standard input] and generates PostScript code that will plot a windrose diagram. Optionally (with -A), polar...
psscale
psscale plots gray scales or color scales on maps. Both horizontal and vertical scales are supported. For CPTs with gradational colors (i.e., the lower and...
pssegy
pssegy reads a native (IEEE) format SEGY file and produces a PostScript image of the seismic data. The imagemask operator is used so that the seismic data are...
pssegyz
pssegyz reads a native (IEEE) format SEGY file and produces a PostScript image of the seismic data. The imagemask operator is used so that the seismic data are...
pssolar
pssolar Calculate and plot the day-night terminator and the civil, nautical and astronomical twilights.
pstext
pstext plots text strings of variable size, font type, and orientation. Various map projections are provided, with the option to draw and annotate the map...
psvelo
psvelo reads data values from files [or standard input] and generates PostScript code that will plot velocity arrows on a map. Most options are the same as for...
pswiggle
pswiggle reads (x,y,z) triplets from files [or standard input] and plots z as a function of distance along track. This means that two consecutive (x,y) points...
psxy
psxy reads (x,y) pairs from files [or standard input] and generates PostScript code that will plot lines, polygons, or symbols at those locations on a map. If a...
psxyz
psxyz reads (x,y,z) triplets from files [or standard input] and generates PostScript code that will plot lines, polygons, or symbols at those locations in 3-D...
rotconverter
rotconverter reads one or more plate motion models (stage or total reconstruction rotations) stored in the given files. If more than one plate motion model is...
sample1d
sample1d reads a multi-column ASCII [or binary] data set from file [or standard input] and interpolates the time-series or spatial profile at locations where...
segy2grd
segy2grd reads an IEEE SEGY file and creates a binary grid file. Either a simple mapping (equivalent to xyz2grd -Z) or a more complicated averaging where a...
spectrum1d
spectrum1d reads X [and Y] values from the first [and second] columns on standard input [or x[y]file]. These values are treated as timeseries X(t) [Y(t)]...
sph2grd
sph2grd reads a spherical harmonics coefficient table with records of L, M, C[L,M], S[L,M] and evaluates the spherical harmonic model on the specified grid.
sphdistance
sphdistance reads one or more ASCII [or binary] files (or standard input) containing lon, lat and performs the construction of Voronoi polygons. These polygons...
sphinterpolate
sphinterpolate reads one or more ASCII [or binary] files (or standard input) containing lon, lat, f and performs a Delaunay triangulation to set up a spherical...
sphtriangulate
sphtriangulate reads one or more ASCII [or binary] files (or standard input) containing lon, lat and performs a spherical Delaunay triangulation, i.e., it find...
splitxyz
splitxyz reads a series of (x,y[,z]) records [or optionally (x,y,z,d,h); see -S option] from standard input [or xyz[dh]file] and splits this into separate lists...
surface
Grid table data using adjustable tension continuous curvature splines
talwani2d
talwani2d will read the multi-segment modeltable from file or standard input. This file contains cross-sections of one or more 2-D bodies, with one polygon per...
talwani3d
talwani3d will read the multi-segment modeltable from file or standard input. This file contains contours of a 3-D body at different z-levels, with one contour...
trend1d
trend1d reads x,y [and w] values from the first two [three] columns on standard input [or file] and fits a regression model y = f(x) + e by [weighted] least...
trend2d
trend2d reads x,y,z [and w] values from the first three [four] columns on standard input [or xyz[w]file] and fits a regression model z = f(x,y) + e by...
triangulate
triangulate reads one or more ASCII [or binary] files (or standard input) containing x,y[,z] and performs Delaunay triangulation, i.e., it find how the points...
x2sys_binlist
x2sys_binlist reads one or more track data files and produces a multisegment ASCII track bin-index file (tbf) with the track name in the header and one data...
x2sys_cross
x2sys_cross is used to determine all intersections between ("external cross-overs") or within ("internal cross-overs") tracks (Cartesian or geographic), and...
x2sys_datalist
x2sys_datalist reads one or more files and produces a single ASCII [or binary] table. The files can be of any format, which must be described and passed with...
x2sys_get
x2sys_get will return the names of the track data files in the x2sys data base for this TAG that match the given requirements. You may choose a specific region...
x2sys_init
x2sys_init is the starting point for anyone wishing to use x2sys; it initializes a set of data bases that are particular to one kind of track data. These data...
x2sys_list
x2sys_list will read the crossover ASCII data base coedbase.txt (or stdin) and extract a subset of the crossovers based on the other arguments. The output may...
x2sys_merge
x2sys_merge will read two crossovers data base and output the contents of the main one updated with the COEs in the second one. The second file should only...
x2sys_put
x2sys_put accepts a track bin-index file created by x2sys_binlist and adds this information about the data tracks to the relevant data base. You may chose to...
x2sys_report
x2sys_report will read the input crossover ASCII data base coedbase.txt (or stdin) and report on the statistics of crossovers (n, mean, stdev, rms, weight) for...
x2sys_solve
x2sys_solve will use the supplied crossover information to solve for systematic corrections that can then be applied per track to improve data quality. Several...
xyz2grd
xyz2grd reads one or more z or xyz tables and creates a binary grid file. xyz2grd will report if some of the nodes are not filled in with data. Such...
File Formats (Section 5)
gmtcolors
Colors can be specified in GMT as arguments to commands, generally as part of the -G or -W options to select polygon fill or outline pen. Colors are also used...
gmt.conf
The following is a list of the parameters that are user-definable in GMT. The parameter names are always given in UPPER CASE. The parameter values are...