mgd77info

贡献者:

周茂

最近更新日期:

2024-06-21

官方文档:

mgd77info

简介:

提取 mgd77 文件信息

mgd77info 读取 xxx.[mgd77|nc] 文件，并提取其中每条测线的相关信息，包括：起止时间， 以 km 为单位的测线长度，经纬度范围，观测个数。并可通过选项指定查看 MGD77 头部数据还是 其成员信息。

使用 x2sys 模块（见 x2sys_init ）可获得哪些轨迹穿过给定区域以及可用的观测类型等信息。

mgd77 文件格式相关信息见 参考文献

语法

gmt mgd77info GEODAS-ids [ -C[m|e] ] [ -E[m|e] ] [ -Ia|c|m|t ] [ -Mf[item]|r|e|h ] [ -L[v] ] [ -V[level] ] [ --PAR=value ]

必选选项

NGDC-ids

可以是 5 种说明符种的一种或者几种:

  1. 8 个字符的 GEODAS ID，例如：01010083，JA010010

  2. 2 个字符的机构 ID，将会返回所有该机构的测线

  3. 4 个字符代码，返回对应机构和测量船的测线，机构和测量船的代码见 mgd77info -L

  4. =list ，list 文件中包含 GEODAS ID 列表，每行一个记录

  5. 什么都不指定，返回所有的测线

如果不指定文件扩展名，则搜索下面 4 个扩展名。搜素顺序为：

  • MGD77+ (“.nc”)

  • MGD77T (“.m77t”)

  • MGD77 (“.mgd77”)

  • 普通文本文件 (“.dat”)

使用 -I 选项可以略过其中的某种或几种格式。

搜索文件时首先在当前目录查找，如果未设置 $MGD77_HOME, 则在默认的 $GMT_SHAREDIR/mgd77 目录查找，如果设置了 $MGD77_HOME，则在其下 的 $MGD77_HOME/mgd77_paths.txt 文件中保存的路径中查找。

可选选项

-C[m|e]

列出 MGD77[+] 文件中所有列的缩写。使用 m 和 e 选项表示仅列出 MGD77 文件或 MGD77+ 文件

-E[m|e]

为每条测线输出单行的总结。 m 选项只对每个 MGD77 字段中非 NaN 值计数， e 选项对其他字段中非 NaN 值计数

-Ia|c|m|t

忽略某些数据格式的文件。a|c|m|t 分别表示忽略 MGD77 ASCII、MGD77+ NetCDF、 MGD77T ASCII 、tab 分隔的普通文本文件。该选项可以重复使用以忽略多个格式

-L[v]

不显示测线信息。只输出 GEOSAR 机构 2 个字符代码以及其名称列表。 v 选项可同时显示每个机构测量船的 4 个字符代码列表。由于上述两列表均十分长， 影响阅读体验，因此这里不给出列表，请用户自己运行命令查看。

-Mf[item]|r|e|h

列出每条测线的头部信息和 MGD77+ 历史记录。

  • f 选项用于展示格式，每行输出一个记录，包括参数和值，可以对该输出结果使用 Unix 文本工具进行搜索。或者，可以追加特定参数的名称 item ，或者使用参数的编号。

  • r 选项用于展示原始的，punchcard 格式的 MGD77 头部信息

  • e 选行用于展示 MGD77+ E77 状态

  • h 选项用于展示 MGD77+ 历史记录

-V[level] (more …)

设置 verbose 等级 [w]

-^ 或 -

显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）

-+ 或 +

显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明

-? 或无参数

显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明

--PAR=value

临时修改GMT参数的值，可重复多次使用。参数列表见 配置参数

示例

从 01010047.mgd77 和 01010008.mgd77 观测数据中提取单行的总结

gmt mgd77info 01010047 01010008 -E > listing.lis

查看 01010047.mgd77 观测数据中原始 MGD77 头部信息

gmt mgd77info 01010047 -Mr

查找 01010047.mgd77 中所有和 Gravity 相关的参数

gmt mgd77info 01010047 -Mf | grep Gravity

查找 01010047.mgd77 中磁采样率 Magnetics_Sampling_Rate 的信息

gmt mgd77info 01010047 -MfMagnetics_Sampling_Rate

查看 MGD77+ 格式文件 01010047.nc 中所有列

gmt mgd77info 01010047 -C

查看 Hawaii 大学（代码 08）搜集的 MGD77+ 格式数据中的 E77 状态

gmt mgd77info 08 -Ia -Me

参考文献

MGD77 (Marine Geophysical Data Exchange Format) 格式见 http://www.ngdc.noaa.gov/mgg/dat/geodas/docs/mgd77.txt.

相关模块

mgd77convert, mgd77header, mgd77list, mgd77magref mgd77manage, mgd77path, mgd77track, mgd77sniffer, mgd77track, x2sys_init