Common files for GMT
The GMT-common package contains common files for GMT (Generic
Mapping Tools) package.
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... 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...