1MGD77TRACK(1) GMT MGD77TRACK(1)
2
3
4
6 mgd77track - Plot track-line map of MGD77 cruises
7
9 mgd77track NGDC-ids
10 -Rregion
11 -Jparameters [ -A[c][size][,spacing] ] [ -B[p|s]parameters ] [
12 -Cf|g|e ] [ -Dastartdate ] [ -Dbstopdate ] [ -F ] [ -Gd|t|ngap ] [
13 -Iignore ] [ -K ] [ -Ltrackticks ] [ -oflags ] [ -pflags ] [ -Sas‐
14 tartdist[u] ] [ -Sbstopdist[u] ] [ -TT|t|dms,mc,mfs,mf,mfc ] [
15 -U[stamp] ] [ -V[level] ] [ -W[-|+][pen] ] [ -Xx_offset ] [
16 -Yy_offset ] [ -pflags ] [ -ttransp ]
17
18 Note: No space is allowed between the option flag and the associated
19 arguments.
20
22 mgd77track reads NGDC MGD77 cruises and creates PostScript code that
23 will plot one or more ship tracks on a map using the specified projec‐
24 tion. The PostScript code is written to standard output.
25
27 NGDC-ids
28 Can be one or more of five kinds of specifiers:
29
30 1. 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
31
32 2. 2-character agency codes which will return all cruises from
33 each agency.
34
35 3. 4-character <agency><vessel> codes, which will return all
36 cruises from those vessels.
37
38 4. =list, where list is a table with NGDC IDs, one per line.
39
40 5. If nothing is specified we return all cruises in the data
41 base.
42
43 (See mgd77info -L for agency and vessel codes). If no file
44 extension is given then we search for files with one of the four
45 known extensions. The search order (and the extensions) tried
46 is MGD77+ (".nc"), MGD77T (".m77t"), MGD77 (".mgd77" ) and plain
47 text file (".dat"). Use -I to ignore one or more of these file
48 types). Cruise files will be looked for first in the current
49 directory and second in all directories listed in
50 $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set it will
51 default to $GMT_SHAREDIR/mgd77].
52
53 -Jparameters (more ...)
54 Select map projection.
55
56 -Rwest/east/south/north[/zmin/zmax][+r][+uunit]
57 west, east, south, and north specify the region of interest, and
58 you may specify them in decimal degrees or in
59 [±]dd:mm[:ss.xxx][W|E|S|N] format Append +r if lower left and
60 upper right map coordinates are given instead of w/e/s/n. The
61 two shorthands -Rg and -Rd stand for global domain (0/360 and
62 -180/+180 in longitude respectively, with -90/+90 in latitude).
63 Alternatively for grid creation, give Rcodelon/lat/nx/ny, where
64 code is a 2-character combination of L, C, R (for left, center,
65 or right) and T, M, B for top, middle, or bottom. e.g., BL for
66 lower left. This indicates which point on a rectangular region
67 the lon/lat coordinate refers to, and the grid dimensions nx and
68 ny with grid spacings via -I is used to create the corresponding
69 region. Alternatively, specify the name of an existing grid
70 file and the -R settings (and grid spacing, if applicable) are
71 copied from the grid. Appending +uunit expects projected (Carte‐
72 sian) coordinates compatible with chosen -J and we inversely
73 project to determine actual rectangular geographic region. For
74 perspective view (-p), optionally append /zmin/zmax. In case of
75 perspective view (-p), a z-range (zmin, zmax) can be appended to
76 indicate the third dimension. This needs to be done only when
77 using the -Jz option, not when using only the -p option. In the
78 latter case a perspective view of the plane is plotted, with no
79 third dimension.
80
82 -A[c][size][,spacing]
83 Append c to annotate using the MGD77 cruise ID [Default uses the
84 filename prefix]. Optional size is the font size in points. The
85 leg annotation font is controlled by FONT_LABEL. By default,
86 each leg is annotated every time it enters the map region.
87 Alternatively, append ,spacing to place this label every spacing
88 units apart along the track. Append one of the units k (km), n
89 (nautical mile), d (day), or h (hour).
90
91 -B[p|s]parameters (more ...)
92 Set map boundary frame and axes attributes.
93
94 -Cf|g|e
95
96 Select procedure for along-track distance calculation:
97 f Flat Earth distances. g Great circle distances
98 [Default]. e Geodesic distances on current GMT ellip‐
99 soid.
100
101 -Dastartdate
102 Do not plot data collected before startdate
103 (yyyy-mm-ddT[hh:mm:ss]) [Default is first day].
104
105 -Dbstopdate
106 Do not plot data collected after stopdate
107 (yyyy-mm-ddT[hh:mm:ss]). [Default is last day].
108
109 -F Do not apply the error bit flags if present in a MGD77+ file
110 [Default will apply these flags upon reading the data].
111
112 -Gd|t|ngap
113 Let successive point separations exceeding dgap (km) or tgap
114 (minutes) indicate a break in the track where we should not draw
115 a line [no gaps recognized]. Repeat to use both types of gap
116 checking. The nN form is used to plot only one every other N
117 points. This is useful to reduce plot file size bat cannot be
118 used (will be ignored) with the other two gap types.
119
120 -Iignore
121 Ignore certain data file formats from consideration. Append
122 a|c|m|t to ignore MGD77 ASCII, MGD77+ netCDF, MGD77T ASCII, or
123 plain table files, respectively. The option may be repeated to
124 ignore more than one format. [Default ignores none].
125
126 -K (more ...)
127 Do not finalize the PostScript plot.
128
129 -Ltrackticks
130 To put time/distance log-marks on the track. E.g. a500ka24ht6h
131 means (a)nnotate every 500 km (k) and 24 h(ours), with (t)ick‐
132 marks every 500 km and 6 hours. Alternatively you may use the
133 modifiers d (days) and n (nautical miles).
134
135 -O (more ...)
136 Append to existing PostScript plot.
137
138 -P (more ...)
139 Select "Portrait" plot orientation.
140
141 -Sastartdist[u]
142 Do not plot data that are less than startdist meter along track
143 from port of departure. Append k for km, m for miles, or n for
144 nautical miles [Default is 0 meters].
145
146 -Sbstopdist[u]
147 Do not plot data that are more than stopdist meter along track
148 from port of departure. Append k for km, m for miles, or n for
149 nautical miles [Default is end of track].
150
151 -TT|t|dms,mc,mfs,mf,mfc
152 Controls the attributes of the three kinds of markers (T for the
153 first time marker in a new day, t for additional time markers in
154 the same day, and d for distance markers). For each of these you
155 can specify the 5 comma-separated attributes markersize, marker‐
156 color, markerfontsize, markerfont, and markerfontcolor. Repeat
157 the -T option for each marker type.
158
159 -U[[just]/dx/dy/][c|label] (more ...)
160 Draw GMT time stamp logo on plot.
161
162 -W[-|+][pen]
163 Append pen used for the trackline. [Defaults: width = default,
164 color = black, style = solid]. A leading + will use the lookup
165 color (via -C) for both symbol fill and outline pen color, while
166 a leading - will set outline pen color and turn off symbol fill.
167
168 -X[a|c|f|r][x-shift[u]]
169
170 -Y[a|c|f|r][y-shift[u]] (more ...)
171 Shift plot origin.
172
173 -V[level] (more ...)
174 Select verbosity level [c].
175
176 -p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more ...)
177 Select perspective view.
178
179 -t[transp] (more ...)
180 Set PDF transparency level in percent.
181
182 -^ or just -
183 Print a short message about the syntax of the command, then
184 exits (NOTE: on Windows just use -).
185
186 -+ or just +
187 Print an extensive usage (help) message, including the explana‐
188 tion of any module-specific option (but not the GMT common
189 options), then exits.
190
191 -? or no arguments
192 Print a complete usage (help) message, including the explanation
193 of all options, then exits.
194
196 To generate a Mercator plot of the track of the cruise 01010007 in the
197 area 70W to 20E, 40S to 20N, using a Mercator scale of 0.1inch/degree,
198 label the tracks with 10 points characters, annotate the boundaries
199 every 10 degrees, draw gridlines every 5 degrees, and mark the track
200 every day and 1000 km, with ticks every 6 hours and 250 km, and send
201 the plot to the default printer, enter the following command:
202
203 gmt mgd77track 01010007 -R70W/20E/40S/20N -Jm0.1 -B10g5 -A10 \
204 -La1da1000kf6hf250k \| lpr
205
207 mgd77info, psbasemap, mgd77list
208
210 The Marine Geophysical Data Exchange Format - MGD77, see
211 http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt
212
214 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
215
216
217
218
2195.4.5 Feb 24, 2019 MGD77TRACK(1)