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 ] [ -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 -F 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              repreated  to  ignore  more  than  one format.  [Default ignores
43              none].
44
45       -V     Report the total number of cruises found.
46

EXAMPLES

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

SEE ALSO

63       GMT(1) mgd77info(1) mgd77list(1) mgd77manage(1) mgd77track(1)
64

REFERENCES

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