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

NAME

6       mgd77path - Get full pathname for MGD77 files
7

SYNOPSIS

9       mgd77path NGDC-ids [ -D ] [ -Iignore ] [ -P[-] ] [ -V ]
10

DESCRIPTION

12       mgd77path  returns  the  full  pathname to one or more MGD77 files. The
13       pathname returned for a given  cruise  may  change  with  time  due  to
14       reshuffling of disks/subdirectories.
15
16       NGDC-ids
17              Can be one or more of five kinds of specifiers:
18              1) 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
19              2) 2-character <agency> codes which will return all cruises from
20              each agency.
21              3) 4-character <agency><vessel> codes,  which  will  return  all
22              cruises from those vessels.
23              4) =<list>, where <list> is a table with NGDC IDs, one per line.
24              5)  If  nothing  is  specified we return all cruises in the data
25              base.
26              (See mgd77info -L for agency and vessel codes).  The ".mgd77" or
27              ".nc"  extensions will automatically be appended, if needed (use
28              -I to ignore certain file types).  Cruise files will  be  looked
29              for first in the current directory and second in all directories
30              listed in $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set
31              it will default to $GMT_SHAREDIR/mgd77].
32

OPTIONS

34       No space between the option flag and the associated arguments.
35
36       -D     Instead  of  cruise listings, just show the directory paths cur‐
37              rently used in the search.
38
39       -I     Ignore certain data  file  formats  from  consideration.  Append
40              a|c|t  to  ignore MGD77 ASCII, MGD77+ netCDF, or plain tab-sepa‐
41              rated  ASCII  table  files,  respectively.  The  option  may  be
42              repeated  to  ignore  more  than  one  format.  [Default ignores
43              none].
44
45       -P     Display the full path to  each  cruise  [Default].   Optionally,
46              append - which will list just the cruise IDs instead.
47
48       -V     Selects verbose mode, which will send progress reports to stderr
49              [Default runs "silently"].  Reports the total number of  cruises
50              found.
51

EXAMPLES

53       To obtain pathnames for cruises 01010008 and 01010007, run
54
55       mgd77path 01010008 01010007
56
57       To  obtain  pathnames  for  cruises  01010008 and 01010007, but only if
58       there are MGD77+ version in netCDF, run
59
60       mgd77path 01010008 01010007 -Ia -It
61
62       To see the list of  active  directories  where  MGD77  files  might  be
63       stored, run
64
65       mgd77path -D
66

SEE ALSO

68       GMT(1) mgd77info(1) mgd77list(1) mgd77manage(1) mgd77track(1)
69

REFERENCES

71       Wessel,  P.,  and W. H. F. Smith, 2009, The Generic Mapping Tools (GMT)
72       version 4.5.0 Technical Reference & Cookbook, SOEST/NOAA.
73       Wessel, P., and W. H. F. Smith, 1998, New, Improved Version of  Generic
74       Mapping Tools Released, EOS Trans., AGU, 79 (47), p. 579.
75       Wessel,  P.,  and W. H. F. Smith, 1995, New Version of the Generic Map‐
76       ping Tools Released, EOS Trans., AGU, 76 (33), p. 329.
77       Wessel, P., and W. H. F. Smith, 1995, New Version of the  Generic  Map‐
78       ping Tools Released, http://www.agu.org/eos_elec/95154e.html, Copyright
79       1995 by the American Geophysical Union.
80       Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and  Dis‐
81       play Data, EOS Trans., AGU, 72 (41), p. 441.
82       The   Marine   Geophysical   Data   Exchange   Format  -  "MGD77",  see
83       http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt
84
85
86
87GMT 4.5.6                         10 Mar 2011                     MGD77PATH(1)
Impressum