1MGD77INFO(1) GMT MGD77INFO(1)
2
6 mgd77info - Extract information about MGD77 files
7
9 mgd77info NGDC-ids [ -C[m|e] ] [ -E[m|e] ] [ -Iignore ] [
10 -Mf[item]|r|e|h ] [ -L[v] ] [ -V[level] ]
11 Note: No space is allowed between the option flag and the associated
13 arguments.
14
16 mgd77info reads <legid>.[mgd77|nc] files and produces a single record
17 of information about each cruise specified. The information includes
18 beginning and end times, total track distances in km, longitude and
19 latitude range, and the total number of geophysical observations.
20 Optionally, choose instead to see the original MGD77 header meta-data
21 section or its individual members.
22 If you need to know which tracks are crossing through a given region
24 and what kinds of geophysical observations are available, consider
25 using the x2sys tools to set up a tracks index data base (see
26 x2sys_init for more information).
27
29 NGDC-ids
30 Can be one or more of five kinds of specifiers:
31 1. 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
33 2. 2-character agency codes which will return all cruises from
35 each agency.
36 3. 4-character <agency><vessel> codes, which will return all
38 cruises from those vessels.
39 4. =list, where list is a table with NGDC IDs, one per line.
41 5. If nothing is specified we return all cruises in the data
43 base.
44 (See mgd77info -L for agency and vessel codes). If no file
46 extension is given then we search for files with one of the four
47 known extensions. The search order (and the extensions) tried
48 is MGD77+ (".nc"), MGD77T (".m77t"), MGD77 (".mgd77" ) and plain
49 text file (".dat"). Use -I to ignore one or more of these file
50 types). Cruise files will be looked for first in the current
51 directory and second in all directories listed in
52 $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set it will
53 default to $GMT_SHAREDIR/mgd77].
54
56 -C[m|e]
57 List abbreviations for all columns present in the MGD77[+]
58 files. Append m or e to limit the display to the MGD77 standard
59 or MGD77+ extended set only.
60 -E[m|e]
62 Give a one-line summary for each cruise listed.
63 -Mf[item]|r|e|h
65 List the meta-data (header) and (if present) the MGD77+ history
66 for each cruise. Append f for a formatted display. This will
67 list individual parameters and their values, one entry per out‐
68 put line, in a format that can be searched using standard UNIX
69 text tools. Alternatively, append the name of a particular
70 parameter (you only need to give enough characters - starting at
71 the beginning - to uniquely identify the item). Give - to dis‐
72 play the list of all parameter names. You may also specify the
73 number of a parameter. For the raw, punchcard-formatted MGD77
74 original header block, append r instead. For the MGD77+ E77 sta‐
75 tus, append e instead. Finally, for the MGD77+ history, append
76 h instead.
77 -Iignore
79 Ignore certain data file formats from consideration. Append
80 a|c|m|t to ignore MGD77 ASCII, MGD77+ netCDF, MGD77T ASCII or
81 plain tab-separated ASCII table files, respectively. The option
82 may be repeated to ignore more than one format. [Default ignores
83 none].
84 -L[v] No cruise information is listed. Instead, we just display a list
86 of the GEODAS institution 2-character codes and their names.
87 Optionally, append v to also display the vessels and their
88 4-character codes for each institution. The following is the
89 list of institutions: (01) LAMONT (LDEO), (02) WOODS HOLE O.I.,
90 (03) NOAA, (04) US ARMY, (05) NEW ZEALAND, (06) US GEOL. SURVEY,
91 (07) OREGON ST. UNIV, (08) U.HAWAII SOEST, (09) US NAVY, (10)
92 UNIV OF TEXAS, (11) RICE UNIV., (12) CANADA, (13) UNIV OF CONN.,
93 (14) U.MIAMI (RSMAS), (15) SCRIPPS INST.OC, (16) CHINA, (17) U
94 RHODE ISLAND, (18) DUKE UNIVERSITY, (19) UNITED KINGDOM, (20)
95 U.WASHINGTON, (22) WESTERN GEOPHY., (23) TEXAS A&M UNIV., (24)
96 AUSTRALIA, (25) MONACO, (29) RUSSIA, (30) SPAIN, (35) NIMA, (58)
97 NETHERLANDS, (60) MIN MGMT SVC, (63) ISRAEL, (67) FRANCE, (71)
98 SOUTH AFRICA, (75) US COAST GUARD, (76) BRAZIL, (77) INT. GRAV.
99 BUR, (83) GERMANY, (84) ORSTOM NEW CAL, (86) CUBA, (87)
100 ARGENTINA, (88) US NSF, (89) INDIA, (90) PORTUGAL, (92) FINLAND,
101 (93) CHILE, (J1) HYDR DEPT JAPAN, (J2) GEOL SRVY JAPAN, (J4)
102 UNIV TOKYO, (J5) KOBE UNIV, (J7) UNIV OF RYUKYUS, (J8) J.O.D.C.
103 JAPAN, (J9) CHIBA UNIV, (JA) INST.POLAR RES., (ZZ) INST NOT
104 CODED.
105 -V[level] (more ...)
107 Select verbosity level [c].
108 -^ or just -
110 Print a short message about the syntax of the command, then
111 exits (NOTE: on Windows just use -).
112 -+ or just +
114 Print an extensive usage (help) message, including the explana‐
115 tion of any module-specific option (but not the GMT common
116 options), then exits.
117 -? or no arguments
119 Print a complete usage (help) message, including the explanation
120 of all options, then exits.
121
123 To get one-line summary information about the cruises 01010047.mgd77
124 and 01010008.mgd77, try
125 gmt mgd77info 01010047 01010008 -E > listing.lis
127 To see the original raw MGD77 header meta-data for cruise
129 01010047.mgd77, run
130 gmt mgd77info 01010047 -Mr
132 To determine all the parameters related to Gravity during cruise
134 01010047.mgd77, run
135 gmt mgd77info 01010047 -Mf | grep Gravity
137 To determine the Magnetic sampling rate used during cruise
139 01010047.mgd77, run
140 gmt mgd77info 01010047 -MfMagnetics_Sampling_Rate
142 To see all the columns that the MGD77+ cruise 01010047.nc contains, run
144 gmt mgd77info 01010047 -C
146 To see the E77 status of all MGD77+ cruises collected by the University
148 of Hawaii (institution 08), run
149 gmt mgd77info 08 -Ia -Me
151
153 mgd77list, mgd77manage, mgd77path, mgd77track, x2sys_init
154
156 The Marine Geophysical Data Exchange Format - MGD77, see
157 http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.
158
160 2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
1615.4.5 Feb 24, 2019 MGD77INFO(1)