NAME

       gmtconvert  -  Converts, Pastes, and/or Extracts columns from ASCII and
       binary 1-D tables

SYNOPSIS

       gmtconvert [ inputfiles] [ -A ] [ -E ] [-FfIcolsfP ] [ -H[nrec] ] [  -L
       ] [ -I ] [ -M[flag] ] [ -S"search string" ] [ -V ] [ -: ] [ -bi[s]n ] [
       -bo[s][n] ] [ -f[i|o]colinfo ]

DESCRIPTION

       gmtconvert reads its standard input [or inputfiles] and writes out  the
       desired  information  to  standard  output.  It can do a combination of
       three things: (1) convert between binary and  ASCII  data  tables,  (2)
       paste corresponding records from multiple files into a single file, (3)
       extract a subset of the columns, (4) only extract segments whose header
       matches  a  text pattern search, (5) just list all multisegment headers
       and no data records, and (6) extract first and  last  data  record  for
       each  segment. Input (and hence output) may have multiple subheaders if
       -M is selected, and ascii tables may have regular headers as well.

       datafile(s)
              ASCII (or binary, see -bi) file(s)  holding  a  number  of  data
              columns.

OPTIONS

       -A     The  records from the input files should be paSted horizontally,
              not appended vertically. [Default  processes  one  file  at  the
              time].  Note  for  binary input, all the files you want to paste
              must have the same number of columns (as set with -bi).   TP  -E
              Only  extract  the  first  and  last  record for each segment of
              interest [Default extracts all records].

       -F     Give a comma-separated list of desired columns or ranges  (0  is
              first column) [Default outputs all columns].

       -H     Input file(s) has Header record(s). Number of header records can
              be changed by editing your  .gmtdefaults4  file.  If  used,  GMT
              default  is  1  header record. Use -Hi if only input data should
              have header records [Default will write out  header  records  if
              the input data have them].

       -I     Invert  the  order  of  rows,  i.e., output the final records in
              reverse order, starting with the last and  ending  up  with  the
              first input row [Default goes forward].

       -L     Only  output a listing of all multisegment header records and no
              data records (requires -M and ascii data).

       -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  and
              -bo[s]n must set the number of output columns explicitly.

       -S     Only  output  those  segments  whose  header record contains the
              specified text string [Default output all segments].

       -V     Selects verbose mode, which will send progress reports to stderr
              [Default runs "silently"].

       -:     Toggles  between  (longitude,latitude)  and (latitude,longitude)
              input and/or output. [Default is (longitude,latitude)].   Append
              i  to  select  input  only  or o to select output only. [Default
              affects both].

       -bi    Selects binary input. Append s for single precision [Default  is
              double].   Append  n  for  the  number  of columns in the binary
              file(s).

       -bo    Selects binary output. Append s for single precision [Default is
              double].   Append  n  for  the  number  of columns in the binary
              file(s).

       -f     Special formatting of input and output  columns  (time  or  geo-
              graphical  data)  Specify  i(nput)  or o(utput) [Default is both
              input and output].  Give one or more columns (or column  ranges)
              separated by commas.  Append T (Absolute calendar time), t (time
              relative to chosen TIME_EPOCH), x (longitude), y  (latitude),  g
              (geographic coordinate), or f (floating point) to each column or
              column range item.

EXAMPLES

       To convert the binary file test.b (single precision) with 4 columns  to
       ASCII:

       gmtconvert test.b -bis4 > test.dat

       To  convert  the multiple segment ASCII table test.d to a double preci-
       sion binary file:

       gmtconvert test.d -M -bo > test.b

       You have an ASCII table with 6 columns and you want to  plot  column  5
       versus column 0. Try

       gmtconvert table.d -F5,0 | psxy ...

       If  the  file  instead is the binary file results.b which has 9 single-
       precision values per record, we extract the last column and columns 4-6
       and write ASCII with the command

       gmtconvert results.b -F8,4-6 -bi9s | psxy ...

       You  want  to  plot  the 2nd column of the file left.d versus the first
       column of file right.d:

       gmtconvert left.d right.d -S -F1,2 | psxy ...
       To extract all segments in the file big_file.d  whose  headers  contain
       the string "RIDGE AXIS", try

       gmtconvert big_file.d -S"RIDGE AXIS" > subset.d

SEE ALSO

       gmt(l), minmax(l)



GMT4.0                            1 Oct 2004                     GMTCONVERT(l)