.. index:: ! mgd77path

*********
mgd77path
*********

.. only:: not man

    mgd77path - Return paths to MGD77 cruises and directories

Synopsis
-------------------

.. include:: ../../common_SYN_OPTs.rst_

**mgd77path** *NGDC-ids* [ |-A|\ [**-**] ] [ |-D| ]
[ |-I|\ *ignore* ]
[ |SYN_OPT-V| ]

|No-spaces|

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
------------------

.. include:: explain_ncid.rst_

Optional Arguments
------------------

.. _-A:

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

.. _-D:

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

.. _-I:

**-I**\ *ignore*
    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:

.. |Add_-V| replace:: Reports the total number of cruises found. 
.. include:: ../../explain_-V.rst_

.. include:: ../../explain_help.rst_

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
--------

:doc:`gmt </gmt>` :doc:`mgd77info`
:doc:`mgd77list`
:doc:`mgd77manage`
:doc:`mgd77track`

References
----------

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