mgd77path(1)

1MGD77PATH(1)                          GMT                         MGD77PATH(1)
2
3
4

NAME

6       mgd77path - Return paths to MGD77 cruises and directories
7

SYNOPSIS

9       mgd77path NGDC-ids [  -A[-] ] [  -D ] [  -Iignore ] [  -V[level] ]
10
11       Note:  No  space  is allowed between the option flag and the associated
12       arguments.
13

DESCRIPTION

15       mgd77path returns the full pathname to one or  more  MGD77  files.  The
16       pathname  returned  for  a  given  cruise  may  change with time due to
17       reshuffling of disks/subdirectories.
18

REQUIRED ARGUMENTS

20       NGDC-ids
21              Can be one or more of five kinds of specifiers:
22
23              1. 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
24
25              2. 2-character agency codes which will return all  cruises  from
26                 each agency.
27
28              3. 4-character  <agency><vessel>  codes,  which  will return all
29                 cruises from those vessels.
30
31              4. =list, where list is a table with NGDC IDs, one per line.
32
33              5. If nothing is specified we return all  cruises  in  the  data
34                 base.
35
36              (See  mgd77info  -L  for  agency  and  vessel codes). If no file
37              extension is given then we search for files with one of the four
38              known  extensions.   The search order (and the extensions) tried
39              is MGD77+ (".nc"), MGD77T (".m77t"), MGD77 (".mgd77" ) and plain
40              text  file (".dat").  Use -I to ignore one or more of these file
41              types). Cruise files will be looked for  first  in  the  current
42              directory    and   second   in   all   directories   listed   in
43              $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set  it  will
44              default to $GMT_SHAREDIR/mgd77].
45

OPTIONAL ARGUMENTS

47       -A[-]  Display  the  full  path  to  each cruise [Default]. Optionally,
48              append - which will list just the cruise IDs instead.
49
50       -D     Instead of cruise listings, just show the directory  paths  cur‐
51              rently used in the search.
52
53       -Iignore
54              Ignore  certain  data  file  formats  from consideration. Append
55              a|c|m|t to ignore MGD77 ASCII, MGD77+ netCDF, MGD77T  ASCII,  or
56              plain  tab-separated ASCII table files, respectively. The option
57              may be repeated to ignore more than one format. [Default ignores
58              none].
59
60       -V[level] (more ...)
61              Select  verbosity level [c]. Reports the total number of cruises
62              found.
63
64       -^ or just -
65              Print a short message about the  syntax  of  the  command,  then
66              exits (NOTE: on Windows just use -).
67
68       -+ or just +
69              Print  an extensive usage (help) message, including the explana‐
70              tion of any module-specific  option  (but  not  the  GMT  common
71              options), then exits.
72
73       -? or no arguments
74              Print a complete usage (help) message, including the explanation
75              of all options, then exits.
76

EXAMPLES

78       To obtain pathnames for cruises 01010008 and 01010007, run
79
80              gmt mgd77path 01010008 01010007
81
82       To obtain pathnames for cruises 01010008  and  01010007,  but  only  if
83       there are MGD77+ version in netCDF, run
84
85              gmt mgd77path 01010008 01010007 -Ia -It
86
87       To  see  the  list  of  active  directories  where MGD77 files might be
88       stored, run
89
90              gmt mgd77path -D
91

REFERENCES

96       The  Marine   Geophysical   Data   Exchange   Format   -   MGD77,   see
97       *http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt*.
98

COPYRIGHT

100       2019, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe
101
102
103
104
1055.4.5                            Feb 24, 2019                     MGD77PATH(1)