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 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 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 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 origin)
              -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral-
              lel)
              -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  Car-
              ree))
              -Jtlon0/scale (TM - Transverse Mercator, with Equator as y = 0)
              -Jtlon0/lat0/scale (TM - Transverse Mercator, set origin)
              -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/[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 manpages.


OPTIONS

       No space between the option flag and the associated arguments.

       -B     Sets map boundary tickmark intervals; see the psbasemap man page
              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  sys-
              tem].

       -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.).   The GMT parameters
              UNIX_TIME and UNIX_TIME_POS can affect the appearance;  see  the
              gmtdefaults man page for details.

       -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  abso-
              lute 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 minutes, enter
       the following command:

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


SEE ALSO

       gmt(GMTMANSECTION), psbasemap(GMTMANSECTION)


REFERENCES

       Wessel, P., and W. H. F. Smith, 2004, The Generic Mapping  Tools  (GMT)
       version 3.4.5 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  Map-
       ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
       Wessel,  P.,  and W. H. F. Smith, 1995, New Version of the Generic Map-
       ping 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 Dis-
       play Data, EOS Trans., AGU, 72 (41), p. 441.



VERSION                              DATE              GMTTRACK(GMTMANSECTION)

Man(1) output converted with man2html