gmtconvert - Convert between ASCII and binary 1-D tables
gmtconvert [ inputfiles] [ -H[nrec] ] [ -M[flag] ] [ -V ] [ -: ] [
-bi[s]n ] [ -bo[s] ]
gmtconvert reads its standard input [or inputfiles] and writes out the
information to standard output. Its main purpose is to convert
between binary and ASCII data tables. Input (and hence output) may
have multiple subheaders if -M is selected.
ASCII (or binary, see -bi) file(s) holding a number of data
-H Input file(s) has Header record(s). Number of header records can
be changed by editing your .gmtdefaults file. If used, GMT
default is 1 header record.
-M Multiple segment file(s). Segments are separated by a special
record. For ASCII files the first character must be flag
[Default is '>']. For binary files all fields must be NaN.
-: Toggles between (longitude,latitude) and (latitude,longitude)
input/output. [Default is (longitude,latitude)].
-bi Selects binary input. Append s for single precision [Default is
double]. Append n for the number of columns in the binary
-bo Selects binary output. Append s for single precision [Default is
To convert the binary file test.b (single precision) with 4 columns to
gmtconvert test.b -bis4 > test.dat
To convert the multiple segment ASCII table test.d to a double
precision binary file, try
gmtconvert test.d -M -bo > test.b
When GMT is installed under a non-UNIX operating system, such as
Windows 95/98/NT or the Cygnus or DJGPP ports of GNU to Windows,
binary output to stdout will not work. This is because stdout is done
in TEXT mode (instead of BINARY) mode; on Unix systems there is only
one mode and no problem. The workaround on Win32 platforms is to
append :bname to the -bo which forces an internal redirection of
output to the file bname. See GMT Technical Reference Appendix L for
Man(1) output converted with