NAME

       mgd77path - Get full pathname for MGD77 files

SYNOPSIS

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

DESCRIPTION

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

       NGDC-ids
              Can be one or more of five kinds of specifiers:
              1) 8-character NGDC IDs, e.g., 01010083, JA010010etc., etc.
              2) 2-character <agency> codes which will return all cruises from each agency.
              3) 4-character <agency><vessel> codes, which will return all cruises from those vessels.
              4) =<list>, where <list> is a table with NGDC IDs, one per line.
              5) If nothing is specified we return all cruises in the data base.
              (See mgd77info  -L  for  agency  and  vessel  codes).   The  ".mgd77"  or  ".nc"  extensions  will
              automatically  be appended, if needed (use -I to ignore certain file types).  Cruise files will be
              looked  for  first  in  the  current  directory  and  second  in   all   directories   listed   in
              $MGD77_HOME/mgd77_paths.txt [If $MGD77_HOME is not set it will default to $GMT_SHAREDIR/mgd77].

OPTIONS

       No space between the option flag and the associated arguments.

       -D     Instead of cruise listings, just show the directory paths currently used in the search.

       -I     Ignore  certain data file formats from consideration. Append a|c|m|t to ignore MGD77 ASCII, MGD77+
              netCDF, MGD77T ASCII or plain tab-separated ASCII table files, respectively.  The  option  may  be
              repeated to ignore more than one format.  [Default ignores none].

       -P     Display  the  full  path  to each cruise [Default].  Optionally, append - which will list just the
              cruise IDs instead.

       -V     Selects verbose mode, which will send  progress  reports  to  stderr  [Default  runs  "silently"].
              Reports the total number of cruises found.

EXAMPLES

       To obtain pathnames for cruises 01010008 and 01010007, run

       mgd77path 01010008 01010007

       To  obtain  pathnames  for cruises 01010008 and 01010007, but only if there are MGD77+ version in netCDF,
       run

       mgd77path 01010008 01010007 -Ia -It

       To see the list of active directories where MGD77 files might be stored, run

       mgd77path -D

SEE ALSO

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

REFERENCES

       Wessel, P., and W. H. F. Smith, 2013, The Generic Mapping Tools (GMT) version 4.5.11 Technical  Reference
       & Cookbook, SOEST/NOAA.
       Wessel,  P.,  and  W.  H.  F.  Smith,  1998, New, Improved Version of Generic Mapping Tools Released, EOS
       Trans., AGU, 79 (47), p. 579.
       Wessel, P., and W. H. F. Smith, 1995, New Version of the Generic Mapping Tools Released, EOS Trans., AGU,
       76 (33), p. 329.
       Wessel,  P.,  and  W.  H.  F.  Smith,  1995,  New  Version  of  the  Generic  Mapping   Tools   Released,
       http://www.agu.org/eos_elec/95154e.html, Copyright 1995 by the American Geophysical Union.
       Wessel, P., and W. H. F. Smith, 1991, Free Software Helps Map and Display Data, EOS Trans., AGU, 72 (41),
       p. 441.
       The       Marine       Geophysical       Data       Exchange       Format       -       "MGD77",      see
       http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt

GMT 4.5.11                                         5 Nov 2013                                    MGD77PATH(1gmt)