NAME

     gmttrack - A shiptrack plotting program


SYNOPSIS

     gmttrack  leg-ids  -Rwest/east/south/north  -Jparameters   [
     -Btickinfo  ] [ -Mtrackticks ] [ -Wpen[red/green/blue][OA] ]
     [ -A[size] ] [ -P ] [ -O ] [ -K ]  [ -U[dx/dy/][label]  ]  [
     -Xx-shift ] [ -Yy-shift ] [ -ccopies ] [ -V  ]


DESCRIPTION

     gmttrack reads gmt cruises and creates PostScript code  that
     will  plot one or more ship tracks on a map using the speci-
     fied projection.  The PostScript code is written to standard
     output.

     leg-ids
          Can be one or more gmtleg-names, like c2104 v3206 etc.

     -R   west, east, south, and  north  specify  the  Region  of
          interest.  To specify boundaries in degrees and minutes
          [and seconds], use the dd:mm[:ss] format.  Append r  if
          lower  left  and  upper right map coordinates are given
          instead of wesn.

     -J   Selects  the  map  projection.  Scale  is  UNIT/degree,
          1:xxxxx,  or width in UNIT (upper case modifier).  UNIT
          is cm, inch, or m, depending on the  MEASURE_UNIT  set-
          ting in .gmtdefaults, but this can be overridden on the
          command line by  appending  the  c,  i,  or  m  to  the
          scale/width value.

          CYLINDRICAL PROJECTIONS:

          -Jclon0/lat0/scale (Cassini)
          -Jjlon0/scale (Miller)
          -Jmscale (Mercator - Greenwich and Equator as origin)
          -Jmlon0/lat0/scale (Mercator - Give meridian and  stan-
          dard parallel)
          -Joalon0/lat0/azimuth/scale (Oblique Mercator  -  point
          and azimuth)
          -Joblon0/lat0/lon1/lat1/scale (Oblique Mercator  -  two
          points)
          -Joclon0/lat0/lonp/latp/scale (Oblique Mercator - point
          and pole)
          -Jqlon0/scale   (Equidistant   Cylindrical   Projection
          (Plate Carree))
          -Jtlon0/scale (TM - Transverse Mercator,  with  Equator
          as y = 0)
          -Jtlon0/lat0/scale (TM - Transverse Mercator, set  ori-
          gin)
          -Juzone/scale (UTM - Universal Transverse Mercator)
          -Jylon0/lats/scale (Basic Cylindrical Projection)
          AZIMUTHAL PROJECTIONS:

          -Jalon0/lat0/scale (Lambert).
          -Jelon0/lat0/scale (Equidistant).
          -Jflon0/lat0/horizon/scale (Gnomonic).
          -Jglon0/lat0/scale (Orthographic).
          -Jslon0/lat0/scale (General Stereographic)

          CONIC PROJECTIONS:

          -Jblon0/lat0/lat1/lat2/scale (Albers)
          -Jdlon0/lat0/lat1/lat2/scale (Equidistant)
          -Jllon0/lat0/lat1/lat2/scale (Lambert)

          MISCELLANEOUS PROJECTIONS:

          -Jhlon0/scale (Hammer)
          -Jilon0/scale (Sinusoidal)
          -Jk[f|s]lon0/scale (Eckert IV (f) and VI (s))
          -Jnlon0/scale (Robinson)
          -Jrlon0/scale (Winkel Tripel)
          -Jvlon0/scale (Van der Grinten)
          -Jwlon0/scale (Mollweide)

          NON-GEOGRAPHICAL PROJECTIONS:

          -Jp[a]scale[/origin]  (polar   (theta,r)   coordinates,
          optional a for azimuths and offset theta [0])
          -Jxx-scale[l|ppow][/y-scale[l|ppow]] (Linear, log,  and
          power scaling)
          More details can be found in the psbasemap manpages.


OPTIONS

     No space between the option flag and  the  associated  argu-
     ments.

     -B   Sets map boundary tickmark intervals. See psbasemap for
          details.

     -A   Annotate each  leg  every  time  it  enters  the  plot.
          Optional size is character size in points.

     -Da  Do   not   plot   data   collected   before   startdate
          (mm/dd/yyyy/hh:mm)  [Default is first day].

     -Db  Do   not   plot   data   collected    after    stopdate
          (mm/dd/yyyy/hh:mm). [Default is last day].

     -K   More PostScript code will be  appended  later  [Default
          terminates the plot system].

     -M   To  put  time/distance  Marks  on   the   track.   E.g.
          a500ka24ht6h  means  (a)nnotate every 500 km (k) and 24
          h(ours), with (t)ickmarks every 500 km and 6 hours.

     -O   Selects Overlay plot mode [Default  initializes  a  new
          plot system].

     -P   Selects  Portrait  plotting  mode   [GMT   Default   is
          Landscape, see gmtdefaults to change this].

     -Sa  Do not plot data that are less than startdist km  along
          track from port of departure. [Default is 0].

     -Sb  Do not plot data that are more than stopdist  km  along
          track  from  port  of  departure. [Default is length of
          track].

     -U   Draw Unix System time stamp on plot.  User may  specify
          where the lower left corner of the stamp should fall on
          the  page  relative  to  lower  left  corner  of  plot.
          Optionally,  append  a label, or c (which will plot the
          command string.)

     -W   pen is thickness of  the  trackline.  [Default  is  1].
          Optionally,  specify  the  rgb  combination to obtain a
          colored trackline [Default is black]. Append O for dOt-
          ted line, a for dAshed. [Default is solid]

     -X -Y
          Shift origin of plot by (x-shift,y-shift).   Prepend  a
          for  absolute  coordinates;  the default (r) will reset
          plot origin.

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

     -c   Specifies the number of plot copies. [Default is 1]


EXAMPLES

     To generate a Mercator plot of the track  of  cruises  C2610
     and V1512 in the area 150E to 154E, 18N to 23N, using a Mer-
     cator scale of 1.5inch/degree,  label  the  tracks  with  10
     points characters, annotate the boundaries every degree, and
     draw gridlines every 30', enter the following command:

     gmttrack c2610 v1512 -R150/154/18/23 -Jm1.5 -B1g30m  -A10  |
     lpr


SEE ALSO

     gmt(l), psbasemap(l)


REFERENCES

     Wessel, P., and W. H. F. Smith, 1999,  The  Generic  Mapping
     Tools  (GMT)  version  3.2  Technical  Reference & Cookbook,
     SOEST/NOAA.
     Wessel, P., and W. H. F. Smith, 1998, New, Improved  Version
     of Generic Mapping Tools Released, EOS Trans., AGU, 79 (47),
     p. 579.
     Wessel, P., and W. H. F. Smith, 1995,  New  Version  of  the
     Generic Mapping Tools Released, EOS Trans., AGU, 76 (33), p.
     329.
     Wessel, P., and W. H. F. Smith, 1995,  New  Version  of  the
     Generic           Mapping           Tools          Released,
     http://www.agu.org/eos_elec/95154e.html, Copyright  1995  by
     the American Geophysical Union.
     Wessel, P., and W. H. F. Smith, 1991,  Free  Software  Helps
     Map and Display Data, EOS Trans., AGU, 72 (41), p. 441.