1GMTTRACK(1) Generic Mapping Tools GMTTRACK(1)
2
6 gmttrack - A shiptrack plotting program
7
9 gmttrack leg-ids -Rwest/east/south/north[r] -Jparameters [
10 -B[p|s]parameters ] [ -Mtrackticks ] [ -Wpen[red/green/blue][OA] ] [
11 -A[size] ] [ -K ] [ -O ] [ -P ] [ -U[just/dx/dy/][c|label] ] [ -V ] [
12 -X[a|c|r][x-shift[u]] ] [ -Y[a|c|r][y-shift[u]] ] [ -ccopies ]
13
15 gmttrack reads gmt cruises and creates PostScript code that will plot
16 one or more ship tracks on a map using the specified projection. The
17 PostScript code is written to standard output.
18 leg-ids
20 Can be one or more gmtleg-names, like c2104 v3206 etc.
21 -J Selects the map projection. Scale is UNIT/degree, 1:xxxxx, or
23 width in UNIT (upper case modifier). UNIT is cm, inch, or m,
24 depending on the MEASURE_UNIT setting in .gmtdefaults4, but this
25 can be overridden on the command line by appending c, i, or m to
26 the scale/width value. When central meridian is optional,
27 default is center of longitude range on -R option. Default
28 standard parallel is the equator. For map height, max dimen‐
29 sion, or min dimension, append h, +, or - to the width, respec‐
30 tively.
31 More details can be found in the psbasemap man pages.
32 CYLINDRICAL PROJECTIONS:
34 -Jclon0/lat0/scale (Cassini)
36 -Jcyl_stere/[lon0/[lat0/]]scale (Cylindrical Stereographic)
37 -Jj[lon0/]scale (Miller)
38 -Jm[lon0/[lat0/]]scale (Mercator)
39 -Jmlon0/lat0/scale (Mercator - Give meridian and standard paral‐
40 lel)
41 -Jo[a]lon0/lat0/azimuth/scale (Oblique Mercator - point and
42 azimuth)
43 -Jo[b]lon0/lat0/lon1/lat1/scale (Oblique Mercator - two points)
44 -Joclon0/lat0/lonp/latp/scale (Oblique Mercator - point and
45 pole)
46 -Jq[lon0/[lat0/]]scale (Cylindrical Equidistant)
47 -Jtlon0/[lat0/]scale (TM - Transverse Mercator)
48 -Juzone/scale (UTM - Universal Transverse Mercator)
49 -Jy[lon0/[lat0/]]scale (Cylindrical Equal-Area)
50 CONIC PROJECTIONS:
52 -Jblon0/lat0/lat1/lat2/scale (Albers)
54 -Jdlon0/lat0/lat1/lat2/scale (Conic Equidistant)
55 -Jllon0/lat0/lat1/lat2/scale (Lambert Conic Conformal)
56 -Jpoly/[lon0/[lat0/]]scale ((American) Polyconic)
57 AZIMUTHAL PROJECTIONS:
59 -Jalon0/lat0[/horizon]/scale (Lambert Azimuthal Equal-Area)
61 -Jelon0/lat0[/horizon]/scale (Azimuthal Equidistant)
62 -Jflon0/lat0[/horizon]/scale (Gnomonic)
63 -Jglon0/lat0[/horizon]/scale (Orthographic)
64 -Jglon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale
65 (General Perspective).
66 -Jslon0/lat0[/horizon]/scale (General Stereographic)
67 MISCELLANEOUS PROJECTIONS:
69 -Jh[lon0/]scale (Hammer)
71 -Ji[lon0/]scale (Sinusoidal)
72 -Jkf[lon0/]scale (Eckert IV)
73 -Jk[s][lon0/]scale (Eckert VI)
74 -Jn[lon0/]scale (Robinson)
75 -Jr[lon0/]scale (Winkel Tripel)
76 -Jv[lon0/]scale (Van der Grinten)
77 -Jw[lon0/]scale (Mollweide)
78 NON-GEOGRAPHICAL PROJECTIONS:
80 -Jp[a]scale[/origin][r|z] (Polar coordinates (theta,r))
82 -Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]] (Linear, log,
83 and power scaling)
84 -R west, east, south, and north specify the Region of interest, and
86 you may specify them in decimal degrees or in
87 [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r if lower left and
88 upper right map coordinates are given instead of w/e/s/n. The
89 two shorthands -Rg and -Rd stand for global domain (0/360 and
90 -180/+180 in longitude respectively, with -90/+90 in latitude).
91 Alternatively, specify the name of an existing grid file and the
92 -R settings (and grid spacing, if applicable) are copied from
93 the grid.
94
96 No space between the option flag and the associated arguments.
97 -B Sets map boundary annotation and tickmark intervals; see the
99 psbasemap man page for all the details.
100 -A Annotate each leg every time it enters the plot. Optional size
102 is character size in points.
103 -Da Do not plot data collected before startdate (mm/dd/yyyy/hh:mm)
105 [Default is first day].
106 -Db Do not plot data collected after stopdate (mm/dd/yyyy/hh:mm).
108 [Default is last day].
109 -K More PostScript code will be appended later [Default terminates
111 the plot system].
112 -M To put time/distance Marks on the track. E.g. a500ka24ht6h means
114 (a)nnotate every 500 km (k) and 24 h(ours), with (t)ickmarks
115 every 500 km and 6 hours.
116 -O Selects Overlay plot mode [Default initializes a new plot sys‐
118 tem].
119 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
121 faults to change this].
122 -Sa Do not plot data that are less than startdist km along track
124 from port of departure. [Default is 0].
125 -Sb Do not plot data that are more than stopdist km along track from
127 port of departure. [Default is length of track].
128 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
130 user may specify the justification of the stamp and where the
131 stamp should fall on the page relative to lower left corner of
132 the plot. For example, BL/0/0 will align the lower left corner
133 of the time stamp with the lower left corner of the plot.
134 Optionally, append a label, or c (which will plot the command
135 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
136 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
137 man page for details. The time string will be in the locale set
138 by the environment variable TZ (generally local time).
139 -W pen is thickness of the trackline. [Default is 1]. Optionally,
141 specify the rgb combination to obtain a colored trackline
142 [Default is black]. Append o for dotted line, a for dashed.
143 [Default is solid].
144 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
146 shift) and optionally append the length unit (c, i, m, p). You
147 can prepend a to shift the origin back to the original position
148 after plotting, or prepend r [Default] to reset the current
149 origin to the new location. If -O is used then the default (x-
150 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
151 r2.5c). Alternatively, give c to align the center coordinate (x
152 or y) of the plot with the center of the page based on current
153 page size.
154 -V Selects verbose mode, which will send progress reports to stderr
156 [Default runs "silently"].
157 -c Specifies the number of plot copies. [Default is 1].
159
161 To generate a Mercator plot of the track of cruises C2610 and V1512 in
162 the area 150E to 154E, 18N to 23N, using a Mercator scale of
163 1.5inch/degree, label the tracks with 10 points characters, annotate
164 the boundaries every degree, and draw gridlines every 30 minutes, and
165 send the plot to the default printer, enter the following command:
166 gmttrack c2610 v1512 -R150/154/18/23 -Jm1.5 -B1g30m -A10 | lpr
168
170 GMT(1), psbasemap(1)
171
173 Wessel, P., and W. H. F. Smith, 2009, The Generic Mapping Tools (GMT)
174 version 4.5.0 Technical Reference & Cookbook, SOEST/NOAA.
175 Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of Generic
176 Mapping Tools Released, EOS Trans., AGU, 79 (47), p. 579.
177 Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Map‐
178 ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
179 Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Map‐
180 ping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright
181 1995 by the American Geophysical Union.
182 Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Dis‐
183 play Data, EOS Trans., AGU, 72 (41), p. 441.
184GMT 4.5.6 10 Mar 2011 GMTTRACK(1)