1MGD77TRACK(1)                         GMT                        MGD77TRACK(1)
2
3
4

NAME

6       mgd77track - Plot track-line map of MGD77 cruises
7

SYNOPSIS

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

DESCRIPTION

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

REQUIRED ARGUMENTS

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

OPTIONAL ARGUMENTS

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

EXAMPLES

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

SEE ALSO

207       mgd77info, psbasemap, mgd77list
208

REFERENCES

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)
Impressum