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




NAME

       mgd77info - Extract information about MGD77 files


SYNOPSIS

       mgd77info   NGDC-ids  [   -C[m|e]  ]  [   -E[m|e]  ]  [  -Iignore  ]  [
       -Mf[item]|r|e|h ] [  -L[v] ] [  -V[level] ]

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


DESCRIPTION

       mgd77info  reads  <legid>.[mgd77|nc] files and produces a single record
       of information about each cruise specified.  The  information  includes
       beginning  and  end  times,  total track distances in km, longitude and
       latitude range, and  the  total  number  of  geophysical  observations.
       Optionally,  choose  instead to see the original MGD77 header meta-data
       section or its individual members.

       If you need to know which tracks are crossing through  a  given  region
       and  what  kinds  of  geophysical  observations are available, consider
       using the x2sys  tools  to  set  up  a  tracks  index  data  base  (see
       x2sys_init for more information).


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

       -C[m|e]
              List abbreviations for  all  columns  present  in  the  MGD77[+]
              files.  Append m or e to limit the display to the MGD77 standard
              or MGD77+ extended set only.

       -E[m|e]
              Give a one-line summary for each cruise listed.

       -Mf[item]|r|e|h
              List the meta-data (header) and (if present) the MGD77+  history
              for  each  cruise.  Append  f for a formatted display. This will
              list individual parameters and their values, one entry per  out-
              put  line,  in a format that can be searched using standard UNIX
              text tools.  Alternatively, append  the  name  of  a  particular
              parameter (you only need to give enough characters - starting at
              the beginning - to uniquely identify the item). Give -  to  dis-
              play  the  list of all parameter names. You may also specify the
              number of a parameter. For the  raw,  punchcard-formatted  MGD77
              original header block, append r instead. For the MGD77+ E77 sta-
              tus, append e instead.  Finally, for the MGD77+ history,  append
              h instead.

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

       -L[v]  No cruise information is listed. Instead, we just display a list
              of the GEODAS institution 2-character  codes  and  their  names.
              Optionally,  append  v  to  also  display  the vessels and their
              4-character codes for each institution.  The  following  is  the
              list  of institutions: (01) LAMONT (LDEO), (02) WOODS HOLE O.I.,
              (03) NOAA, (04) US ARMY, (05) NEW ZEALAND, (06) US GEOL. SURVEY,
              (07)  OREGON  ST.  UNIV, (08) U.HAWAII SOEST, (09) US NAVY, (10)
              UNIV OF TEXAS, (11) RICE UNIV., (12) CANADA, (13) UNIV OF CONN.,
              (14)  U.MIAMI  (RSMAS), (15) SCRIPPS INST.OC, (16) CHINA, (17) U
              RHODE ISLAND, (18) DUKE UNIVERSITY, (19)  UNITED  KINGDOM,  (20)
              U.WASHINGTON,  (22)  WESTERN GEOPHY., (23) TEXAS A&M UNIV., (24)
              AUSTRALIA, (25) MONACO, (29) RUSSIA, (30) SPAIN, (35) NIMA, (58)
              NETHERLANDS,  (60)  MIN MGMT SVC, (63) ISRAEL, (67) FRANCE, (71)
              SOUTH AFRICA, (75) US COAST GUARD, (76) BRAZIL, (77) INT.  GRAV.
              BUR,  (83)  GERMANY,  (84)  ORSTOM  NEW  CAL,  (86)  CUBA,  (87)
              ARGENTINA, (88) US NSF, (89) INDIA, (90) PORTUGAL, (92) FINLAND,
              (93)  CHILE,  (J1)  HYDR  DEPT JAPAN, (J2) GEOL SRVY JAPAN, (J4)
              UNIV TOKYO, (J5) KOBE UNIV, (J7) UNIV OF RYUKYUS, (J8)  J.O.D.C.
              JAPAN,  (J9)  CHIBA  UNIV,  (JA)  INST.POLAR RES., (ZZ) INST NOT
              CODED.

       -V[level] (more a|)
              Select verbosity level [c].

       -^ 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 get one-line summary information about  the  cruises  01010047.mgd77
       and 01010008.mgd77, try

              gmt mgd77info 01010047 01010008 -E > listing.lis

       To   see   the   original   raw   MGD77  header  meta-data  for  cruise
       01010047.mgd77, run

              gmt mgd77info 01010047 -Mr

       To determine all  the  parameters  related  to  Gravity  during  cruise
       01010047.mgd77, run

              gmt mgd77info 01010047 -Mf | grep Gravity

       To   determine   the   Magnetic   sampling   rate  used  during  cruise
       01010047.mgd77, run

              gmt mgd77info 01010047 -MfMagnetics_Sampling_Rate

       To see all the columns that the MGD77+ cruise 01010047.nc contains, run

              gmt mgd77info 01010047 -C

       To see the E77 status of all MGD77+ cruises collected by the University
       of Hawaii (institution 08), run

              gmt mgd77info 08 -Ia -Me


SEE ALSO

       mgd77list(1), mgd77manage(1), mgd77path(1), mgd77track(1),
       x2sys_init(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                     mgd77info(1)

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