gmttrack

       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
       specified 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 min­
              utes [and  seconds],  use  the  dd:mm[:ss]  format.
              Append  r if lower left and upper right map coordi­
              nates 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  MEA­
              SURE_UNIT  setting 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 ori­
              gin)
              -Jmlon0/lat0/scale (Mercator -  Give  meridian  and
              standard 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 Equa­
              tor as y = 0)
              -Jtlon0/lat0/scale (TM - Transverse  Mercator,  set
              origin)
              -Juzone/scale (UTM - Universal Transverse Mercator)

              -Jalon0/lat0/scale (Lambert).
              -Jelon0/lat0/scale (Equidistant).
              -Jflon0/lat0/horizon/scale (Gnomonic).
              -Jglon0/lat0/scale (Orthographic).
              -Jslon0/lat0/[slat/]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  man­
              pages.

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.
              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 spec­
              ify 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
              dOtted 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
       Mercator 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 com­
       mand:'

       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,
       sion 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: 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.