manpagez: man pages & more
man mgd77path(1)
Home | html | info | man
mgd77path(1)                          GMT                         mgd77path(1)




NAME

       mgd77path - Return paths to MGD77 cruises and directories


SYNOPSIS

       mgd77path NGDC-ids [  -A[-] ] [  -D ] [  -Iignore ] [  -V[level] ]

       Note:  No  space  is allowed between the option flag and the associated
       arguments.


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.


REQUIRED ARGUMENTS

       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). If no file
              extension is given then we search for files with one of the four
              known  extensions.   The search order (and the extensions) tried
              is MGD77+ (a.nca), MGD77T (a.m77ta), MGD77 (a.mgd77a ) and plain
              text  file (a.data).  Use -I to ignore one or more of these 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].


OPTIONAL ARGUMENTS

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

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

       -Iignore
              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].

       -V[level] (more a|)
              Select  verbosity level [c]. Reports the total number of cruises
              found.

       -^ or just -
              Print a short message about the  syntax  of  the  command,  then
              exits (NOTE: on Windows just use -).

       -+ or just +
              Print  an extensive usage (help) message, including the explana-
              tion of any module-specific  option  (but  not  the  GMT  common
              options), then exits.

       -? or no arguments
              Print a complete usage (help) message, including the explanation
              of all options, then exits.


EXAMPLES

       To obtain pathnames for cruises 01010008 and 01010007, run

              gmt mgd77path 01010008 01010007

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

              gmt mgd77path 01010008 01010007 -Ia -It

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

              gmt mgd77path -D


SEE ALSO

       gmt(1), mgd77info(1), mgd77list(1), mgd77manage(1), mgd77track(1)


REFERENCES

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


COPYRIGHT

       2017, P. Wessel, W. H. F. Smith, R. Scharroo, J. Luis, and F. Wobbe



5.4.2                            Jun 24, 2017                     mgd77path(1)

gmt5 5.4.2 - Generated Thu Jun 29 14:49:46 CDT 2017
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.