1MGD77INFO(1)                 Generic Mapping Tools                MGD77INFO(1)
2
3
4

NAME

6       mgd77info - Get information about MGD77[+] files
7

SYNOPSIS

9       mgd77info   NGDC-ids   [   -C[m|e]  ]  [  -E[m|e]  ]  [  -Iignore  ]  [
10       -Mf[item]|r|e|h ] [ -L[v] [ -V ]
11

DESCRIPTION

13       mgd77info reads <legid>.[mgd77|nc] files and produces a  single  record
14       of  information  about each cruise specified.  The information includes
15       beginning and end times, total track distances  in  km,  longitude  and
16       latitude  range,  and  the  total  number  of geophysical observations.
17       Optionally, choose instead to see the original MGD77  header  meta-data
18       section or its individual members.
19       If  you  need  to know which tracks are crossing through a given region
20       and what kinds of  geophysical  observations  are  available,  consider
21       using  the  x2sys  tools  to  set  up  a  tracks  index  data base (see
22       x2sys_init for more information).
23
24       NGDC-ids
25              Can be one or more of five kinds of specifiers:
26              1) 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
27              2) 2-character <agency> codes which will return all cruises from
28              each agency.
29              3)  4-character  <agency><vessel>  codes,  which will return all
30              cruises from those vessels.
31              4) =<list>, where <list> is a table with NGDC IDs, one per line.
32              5) If nothing is specified we return all  cruises  in  the  data
33              base.
34              (See mgd77info -F for agency and vessel codes).  The ".mgd77" or
35              ".nc" extensions will automatically be appended, if needed  (use
36              -I  to  ignore certain file types).  Cruise files will be looked
37              for first in the current directory and second in all directories
38              listed in $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set
39              it will default to $GMT_SHAREDIR/mgd77].
40

OPTIONS

42       No space between the option flag and the associated arguments.
43
44       -C     List abbreviations for  all  columns  present  in  the  MGD77[+]
45              files.  Append m or e to limit the display to the MGD77 standard
46              or MGD77+ extended set only.
47
48       -E     Give a one-line summary for each cruise listed.
49
50       -M     List the meta-data (header) and (if present) the MGD77+  history
51              for  each  cruise.  Append f for a formatted display.  This will
52              list individual parameters and their values, one entry per  out‐
53              put  line,  in a format that can be searched using standard UNIX
54              text tools.  Alternatively, append  the  name  of  a  particular
55              parameter (you only need to give enough characters - starting at
56              the beginning - to uniquely identify the item).  Give - to  dis‐
57              play  the list of all parameter names.  You may also specify the
58              number of a parameter.  For the raw,  punchcard-formatted  MGD77
59              original  header  block,  append  r instead.  For the MGD77+ E77
60              status, append e instead.   Finally,  for  the  MGD77+  history,
61              append h instead.
62
63       -I     Ignore  certain  data  file  formats  from consideration. Append
64              a|c|t to ignore MGD77 ASCII, MGD77+ netCDF, or  plain  tab-sepa‐
65              rated  ASCII  table  files,  respectively.  The  option  may  be
66              repreated to ignore more  than  one  format.   [Default  ignores
67              none].
68
69       -L     No  cruise  information  is  listed.  Instead, we just display a
70              list of the  GEODAS  institution  2-character  codes  and  their
71              names.   Optionally,  append  v  to also display the vessels and
72              their 4-character codes for each institution.  The following  is
73              the list of institutions:
74              (01)  LAMONT  (LDEO),  (02)  WOODS HOLE O.I., (03) NOAA, (04) US
75              ARMY, (05) NEW ZEALAND, (06) US GEOL. SURVEY,  (07)  OREGON  ST.
76              UNIV,  (08)  U.HAWAII  SOEST,  (09) US NAVY, (10) UNIV OF TEXAS,
77              (11) RICE UNIV., (12) CANADA, (13) UNIV OF CONN.,  (14)  U.MIAMI
78              (RSMAS),  (15) SCRIPPS INST.OC, (16) CHINA, (17) U RHODE ISLAND,
79              (18) DUKE UNIVERSITY, (19) UNITED  KINGDOM,  (20)  U.WASHINGTON,
80              (22) WESTERN GEOPHY., (23) TEXAS A&M UNIV., (24) AUSTRALIA, (25)
81              MONACO, (29) RUSSIA, (30) SPAIN, (35)  NIMA,  (58)  NETHERLANDS,
82              (60)  MIN MGMT SVC, (63) ISRAEL, (67) FRANCE, (71) SOUTH AFRICA,
83              (75) US COAST GUARD, (76) BRAZIL, (77) INT. GRAV. BUR, (83) GER‐
84              MANY,  (84)  ORSTOM  NEW CAL, (86) CUBA, (87) ARGENTINA, (88) US
85              NSF, (89) INDIA, (90) PORTUGAL, (92) FINLAND, (93)  CHILE,  (J1)
86              HYDR  DEPT  JAPAN,  (J2)  GEOL SRVY JAPAN, (J4) UNIV TOKYO, (J5)
87              KOBE UNIV, (J7) UNIV OF RYUKYUS, (J8) J.O.D.C. JAPAN, (J9) CHIBA
88              UNIV, (JA) INST.POLAR RES., (ZZ) INST NOT CODED.
89
90       -V     Selects verbose mode, which will send progress reports to stderr
91              [Default runs "silently"].
92

EXAMPLES

94       To get one-line summary information about  the  cruises  01010047.mgd77
95       and 01010008.mgd77, try
96
97       mgd77info 01010047 01010008 -E > listing.lis
98
99       To   see   the   original   raw   MGD77  header  meta-data  for  cruise
100       01010047.mgd77, run
101
102       mgd77info 01010047 -Mr
103
104       To determine all  the  parameters  related  to  Gravity  during  cruise
105       01010047.mgd77, run
106
107       mgd77info 01010047 -Mf | grep Gravity
108
109       To   determine   the   Magnetic   sampling   rate  used  during  cruise
110       01010047.mgd77, run
111
112       mgd77info 01010047 -MfMagnetics_Sampling_Rate
113
114       To see all the columns that the MGD77+ cruise 01010047.nc contains, run
115
116       mgd77info 01010047 -C
117
118       To see the E77 status of all MGD77+ cruises collected by the University
119       of Hawaii, run
120
121       mgd77info 08 -Ia -Me
122

SEE ALSO

124       mgd77list(1), mgd77manage(1), mgd77path(1), mgd77track(1) x2sys_init(1)
125

REFERENCES

127       Wessel,  P.,  and W. H. F. Smith, 2005, The Generic Mapping Tools (GMT)
128       version 4.1 Technical Reference & Cookbook, SOEST/NOAA.
129       Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of  Generic
130       Mapping Tools Released, EOS Trans., AGU, 79 (47), p. 579.
131       Wessel,  P.,  and W. H. F. Smith, 1995, New Version of the Generic Map‐
132       ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
133       Wessel, P., and W. H. F. Smith, 1995, New Version of the  Generic  Map‐
134       ping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright
135       1995 by the American Geophysical Union.
136       Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and  Dis‐
137       play Data, EOS Trans., AGU, 72 (41), p. 441.
138       The   Marine   Geophysical   Data   Exchange   Format  -  "MGD77",  see
139       http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt
140
141
142
143GMT 4.3.1                         15 May 2008                     MGD77INFO(1)
Impressum