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 AZIMUTHAL PROJECTIONS:
58 -Jalon0/lat0[/horizon]/scale (Lambert Azimuthal Equal-Area)
60 -Jelon0/lat0[/horizon]/scale (Azimuthal Equidistant)
61 -Jflon0/lat0[/horizon]/scale (Gnomonic)
62 -Jglon0/lat0[/horizon]/scale (Orthographic)
63 -Jglon0/lat0/altitude/azimuth/tilt/twist/Width/Height/scale
64 (General Perspective).
65 -Jslon0/lat0[/horizon][/slat]/scale (General Stereographic)
66 MISCELLANEOUS PROJECTIONS:
68 -Jh[lon0/]scale (Hammer)
70 -Ji[lon0/]scale (Sinusoidal)
71 -Jkf[lon0/]scale (Eckert IV)
72 -Jk[s][lon0/]scale (Eckert IV)
73 -Jn[lon0/]scale (Robinson)
74 -Jr[lon0/]scale (Winkel Tripel)
75 -Jv[lon0/]scale (Van der Grinten)
76 -Jw[lon0/]scale (Mollweide)
77 NON-GEOGRAPHICAL PROJECTIONS:
79 -Jp[a]scale[/origin][r|z] (Polar coordinates (theta,r))
81 -Jxx-scale[d|l|ppow|t|T][/y-scale[d|l|ppow|t|T]] (Linear, log,
82 and power scaling)
83 -R west, east, south, and north specify the Region of interest, and
85 you may specify them in decimal degrees or in
86 [+-]dd:mm[:ss.xxx][W|E|S|N] format. Append r if lower left and
87 upper right map coordinates are given instead of w/e/s/n. The
88 two shorthands -Rg and -Rd stand for global domain (0/360 and
89 -180/+180 in longitude respectively, with -90/+90 in latitude).
90
92 No space between the option flag and the associated arguments.
93 -B Sets map boundary annotation and tickmark intervals; see the
95 psbasemap man page for all the details.
96 -A Annotate each leg every time it enters the plot. Optional size
98 is character size in points.
99 -Da Do not plot data collected before startdate (mm/dd/yyyy/hh:mm)
101 [Default is first day].
102 -Db Do not plot data collected after stopdate (mm/dd/yyyy/hh:mm).
104 [Default is last day].
105 -K More PostScript code will be appended later [Default terminates
107 the plot system].
108 -M To put time/distance Marks on the track. E.g. a500ka24ht6h means
110 (a)nnotate every 500 km (k) and 24 h(ours), with (t)ickmarks
111 every 500 km and 6 hours.
112 -O Selects Overlay plot mode [Default initializes a new plot sys‐
114 tem].
115 -P Selects Portrait plotting mode [Default is Landscape, see gmtde‐
117 faults to change this].
118 -Sa Do not plot data that are less than startdist km along track
120 from port of departure. [Default is 0].
121 -Sb Do not plot data that are more than stopdist km along track from
123 port of departure. [Default is length of track].
124 -U Draw Unix System time stamp on plot. By adding just/dx/dy/, the
126 user may specify the justification of the stamp and where the
127 stamp should fall on the page relative to lower left corner of
128 the plot. For example, BL/0/0 will align the lower left corner
129 of the time stamp with the lower left corner of the plot.
130 Optionally, append a label, or c (which will plot the command
131 string.). The GMT parameters UNIX_TIME, UNIX_TIME_POS, and
132 UNIX_TIME_FORMAT can affect the appearance; see the gmtdefaults
133 man page for details. The time string will be in the locale set
134 by the environment variable TZ (generally local time).
135 -W pen is thickness of the trackline. [Default is 1]. Optionally,
137 specify the rgb combination to obtain a colored trackline
138 [Default is black]. Append o for dotted line, a for dashed.
139 [Default is solid].
140 -X -Y Shift plot origin relative to the current origin by (x-shift,y-
142 shift) and optionally append the length unit (c, i, m, p). You
143 can prepend a to shift the origin back to the original position
144 after plotting, or prepend r [Default] to reset the current
145 origin to the new location. If -O is used then the default (x-
146 shift,y-shift) is (0,0), otherwise it is (r1i, r1i) or (r2.5c,
147 r2.5c). Alternatively, give c to align the center coordinate (x
148 or y) of the plot with the center of the page based on current
149 page size.
150 -V Selects verbose mode, which will send progress reports to stderr
152 [Default runs "silently"].
153 -c Specifies the number of plot copies. [Default is 1].
155
157 To generate a Mercator plot of the track of cruises C2610 and V1512 in
158 the area 150E to 154E, 18N to 23N, using a Mercator scale of
159 1.5inch/degree, label the tracks with 10 points characters, annotate
160 the boundaries every degree, and draw gridlines every 30 minutes, and
161 send the plot to the default printer, enter the following command:
162 gmttrack c2610 v1512 -R150/154/18/23 -Jm1.5 -B1g30m -A10 | lpr
164
166 GMT(1), psbasemap(1)
167
169 Wessel, P., and W. H. F. Smith, 2005, The Generic Mapping Tools (GMT)
170 version 4.1 Technical Reference & Cookbook, SOEST/NOAA.
171 Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of Generic
172 Mapping Tools Released, EOS Trans., AGU, 79 (47), p. 579.
173 Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Map‐
174 ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
175 Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Map‐
176 ping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright
177 1995 by the American Geophysical Union.
178 Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Dis‐
179 play Data, EOS Trans., AGU, 72 (41), p. 441.
180GMT 4.3.1 15 May 2008 GMTTRACK(1)