Permalink
Browse files

update to GMT 5.3.1 (r17229)

  • Loading branch information...
1 parent 4c552eb commit 15524e64063021c739d8e607cde4404a7eb45a7d @seisman seisman committed Apr 8, 2016
View
@@ -2,9 +2,8 @@
[![Sphinx](https://img.shields.io/badge/Powered%20by-Sphinx-orange.svg)](http://www.sphinx-doc.org/)
[![Build Status](https://travis-ci.org/gmt-china/GMT_modules.svg?branch=master)](https://travis-ci.org/gmt-china/GMT_modules)
-[![GMT_Release](https://img.shields.io/badge/GMT%20Release-v5.2.1-blue.svg)](http://gmt.soest.hawaii.edu/)
+[![GMT_Release](https://img.shields.io/badge/GMT%20Release-v5.3.1-blue.svg)](http://gmt.soest.hawaii.edu/)
[![Release](https://img.shields.io/github/release/gmt-china/GMT_modules.svg)](https://github.com/gmt-china/GMT_docs/releases)
-[![GitHub commits](https://img.shields.io/github/commits-since/gmt-china/GMT_modules/v5.2.1.svg)]()
[![License (CC BY-NC 4.0 CN)](https://img.shields.io/badge/license-CC%20BY--NC%204.0-red.svg)](http://creativecommons.org/licenses/by-nc/4.0/)
欢迎来到 GMT(Generic Mapping Tools) 的世界。
@@ -22,7 +21,7 @@
## 版本说明
-本手册目前与GMT 5.2.1同步。手册有正式发布(release)版和维护开发(dev)版。
+本手册目前与GMT 5.3.1同步。手册有正式发布(release)版和维护开发(dev)版。
### release版
@@ -10,7 +10,7 @@
inventory_header = '''\
# Sphinx inventory version 2
# Project: GMT
-# Version: 5.2.1
+# Version: 5.3.1
# The remainder of this file is compressed with zlib.
'''.encode('utf-8')
View
@@ -10,7 +10,7 @@
inventory_header = '''\
# Sphinx inventory version 2
# Project: GMT
-# Version: 5.2.1
+# Version: 5.3.1
# The remainder of this file is compressed with zlib.
'''.encode('utf-8')
@@ -32,7 +32,8 @@
'psconvert', 'psbasemap', 'psclip', 'pscoast', 'pstext',
'psxy', 'project', 'pscontour', 'pshistogram', 'psimage',
- 'pslegend', 'psmask', 'psrose', 'psscale', 'pswiggle', 'psxyz',
+ 'pslegend', 'psmask', 'psrose', 'psscale', 'pssolar',
+ 'pswiggle', 'psxyz',
'sample1d', 'spectrum1d', 'sph2grd', 'sphdistance',
'sphinterpolate', 'sphtriangulate', 'splitxyz', 'surface',
@@ -42,16 +43,16 @@
supplements = {
'gshhg' : ['gshhg'],
'img' : ['img2google', 'img2grd'],
- 'meca' : ['pscoupe', 'psmeca', 'pspolar', 'psvelo'],
+ 'meca' : ['pscoupe', 'psmeca', 'pspolar', 'pssac', 'psvelo'],
'mgd77' : ['mgd77info', 'mgd77magref', 'mgd77path', 'mgd77track',
'mgd77convert', 'mgd77list', 'mgd77manage', 'mgd77sniffer'],
'misc' : ['dimfilter'],
- 'potential': ['gmtgravmag3d', 'gravfft', 'grdgravmag3d', 'grdredpol',
- 'grdseamount', 'gmtflexure', 'grdflexure', 'talwani2d',
- 'talwani3d'],
+ 'potential': ['gmtgravmag3d', 'gpsgridder', 'gravfft', 'grdgravmag3d',
+ 'grdredpol', 'grdseamount', 'gmtflexure', 'grdflexure',
+ 'talwani2d', 'talwani3d'],
'segy' : ['pssegy', 'pssegyz', 'segy2grd'],
- 'spotter': ['backtracker', 'grdpmodeler', 'grdspotter', 'originator',
- 'grdrotater', 'hotspotter', 'rotconverter'],
+ 'spotter': ['backtracker', 'gmtpmodeler', 'grdpmodeler', 'grdspotter',
+ 'originator', 'grdrotater', 'hotspotter', 'rotconverter'],
'x2sys' : ['x2sys_cross', 'x2sys_init', 'x2sys_put', 'x2sys_datalist',
'x2sys_list', 'x2sys_report', 'x2sys_binlist', 'x2sys_get',
'x2sys_merge', 'x2sys_solve'],
View
@@ -66,9 +66,9 @@
# built documents.
#
# The short X.Y version.
-version = '5.2.1'
+version = '5.3.1'
# The full version, including alpha/beta/rc tags.
-release = '5.2.1-dev'
+release = '5.3.1'
# The language for content autogenerated by Sphinx. Refer to documentation
# for a list of supported languages.
@@ -321,6 +321,6 @@
# Example configuration for intersphinx: refer to the Python standard library.
intersphinx_mapping = {
- 'gmt': ('http://gmt.soest.hawaii.edu/doc/5.2.1/', 'gmt.inv'),
+ 'gmt': ('http://gmt.soest.hawaii.edu/doc/5.3.1/', 'gmt.inv'),
'doc': ('http://docs.gmt-china.org/', 'docs.inv')
}
View
Binary file not shown.
View
@@ -15,7 +15,7 @@ filter1d
``-E``
输出时间序列的首尾端数据。默认情况下,首尾两端都会丢失半滤波器宽度的数据点
-``-F<type><width>[<mode>]``
+``-F<type><width>[<mode>][+h]``
设置滤波器类型
滤波器分为两大类,卷积滤波器和非卷积滤波器。 ``<type>`` 用于指定滤波器类型, ``<width>`` 指定滤波器宽度(单位与时间数据相同)。
@@ -41,6 +41,8 @@ filter1d
In the case of **L**\ \|\ **U** it is possible that no data passes
the initial sign test; in that case the filter will return 0.0.
+ 该模块默认对数据进行低通滤波,加上 ``+h`` 选项则对数据进行高通滤波。
+
``-I<ignore_val>``
若输出数据等于 ``<ignore_val>`` ,则设置其值为NaN
View
Binary file not shown.
View
@@ -72,6 +72,9 @@ gmtinfo
对于某些算法,比如FFT或者surface命令, ``-R`` 选项的不同取值会影响到运算的速度, ``-If`` 会输出优化后的 ``-R`` 以得到最快FFT结果, ``-Is`` 会输出优化后的 ``-R`` 以得到最快的surface结果。
+``-L``
+ 确定多个表数据( ``-Af`` )或多段数据( ``-As`` )的共同范围。若与 ``-I`` 选项连用,则最终的结果会向内近似以使得极值位于真实数据范围内。
+
``-S``
见官方文档。
@@ -0,0 +1,6 @@
+.. index:: ! gmtpmodeler
+
+gmtpmodeler
+===========
+
+:官方文档: :ref:`gmt:gmtpmodeler`
View
@@ -8,16 +8,17 @@ gmtselect
该命令会从输入文件中读取前两列作为经度和纬度,并判断经纬度是否符合一定的空间准则,以筛选出符合条件的记录。输入文件中仅前两列会被使用。
-六个空间准则包括
+七个空间准则包括
#. 在矩形区域内( ``-R````-J``
#. 与 ``ptfile`` 中的每个点的距离在 ``dist`` 之内
#. 与 ``linefile`` 中的每条线的距离在 ``dist`` 之内
#. 在 ``polygonfile`` 中的多边形内
#. 在某个地理区域内(需要海岸线数据)
#. z值在某个范围内
+#. 该点所在的网格单元内具有有效值(即非零和非NaN的值)
-六个空间准则
+七个空间准则
------------
准则1
@@ -26,26 +27,26 @@ gmtselect
gmt select points.xy -R0/5/0/5
准则2
- 与 ``<ptfile>`` 中的每个点的距离在 ``<dist>`` 内,由 ``-C`` 选项控制,其语法为::
+ 与 ``<pointfile>`` 中的每个点的距离在 ``<dist>`` 内,由 ``-C`` 选项控制,其语法为::
- -C<dist>[<unit>]/<ptfile>
+ -C<pointfile>+d<dist>[<unit>]
- 该准则会筛选出与文件 ``<ptfile>`` 中的每个点的距离在 ``<dist>`` 之内的记录。若 ``dist`` 等于0,则 ``<ptfile>`` 中的第三列是每个数据点各自的影响半径,即筛选出不在任何一个数据点的影响半径内的点。
+ 该准则会筛选出与文件 ``<pointfile>`` 中的每个点的距离在 ``<dist>`` 之内的记录。若 ``dist`` 等于0,则 ``<pointfile>`` 中的第三列是每个数据点各自的影响半径,即筛选出不在任何一个数据点的影响半径内的点。
默认情况下 ``<dist>`` 是笛卡尔坐标系下的距离,单位为用户单位。若指定 ``-fg`` 选项,则表明 ``<dist>`` 为球面距离。若使用了 ``-R````-J`` ,则 ``<dist>`` 表示投影后的纸面距离。
准则3
``linefile`` 中的每条线的距离在 ``dist`` 之内,由 ``-L`` 选项控制,其语法为::
- -L[p]<dist>[<unit>]/<linefile>
+ -L<linefile>+d<dist>[<unit>][+p]
``<linefile>`` 中包含了一系列线段,该准则会筛选出与这些线段的距离不超过 ``<dist>`` 的记录。
- 若 ``<dist>``\ 等于零,则可以在 ``<ptfile>`` 中每段数据的段头记录中使用 ``-D<dist>`` 参数,为每个线段分别指定距离值。
+ 若 ``<dist>`` 等于零,则可以在 ``<linefile>`` 中每段数据的段头记录中使用 ``-D<dist>`` 参数,为每个线段分别指定距离值。
默认情况下 ``<dist>`` 是笛卡尔坐标系下的距离,单位为用户单位。若指定 ``-fg`` 选项,则表明 ``<dist>`` 为球面距离。若使用了 ``-R````-J`` ,则 ``<dist>`` 表示投影后的纸面距离。
- 使用 ``-Lp`` 则会将数据点垂直投影到线段上,只有投影的位置在线段的端点内的记录才会被保留,即只有线段左右一定距离内的点才会被保留,线段两端点一定距离内的点不会被保留。
+ 使用 ``+p`` 则会将数据点垂直投影到线段上,只有投影的位置在线段的端点内的记录才会被保留,即只有线段左右一定距离内的点才会被保留,线段两端点一定距离内的点不会被保留。
准则4
筛选出在某个多边形内的点,由 ``-F`` 选项控制,其语法为::
@@ -74,6 +75,9 @@ gmtselect
若想要对多列做类似的测试,可以重复使用-Z选项,每次指定不同的列号。
+准则7
+ 使用 ``-G<gridmask>`` 指定一个网格文件。对于每个数据点而言,判断其对应的网格单元是否具有有效值(即非零或非NaN的值),若该网格单元有有效值,则保留该数据点。
+
选项
----
@@ -86,23 +90,23 @@ gmtselect
``-E[fn]``
在判断点是否在一个多边形内时,默认会将恰好在多边形上的点也认为是在多边形内,使用该选项会将多边形上的点认为是在多边形外部。 ``f````n`` 分别对应于 ``-F````-N`` 选项。
-``-I[cflrsz]``
- 对六个准则取反,即筛选出不符合准则的记录。c、f、l、r、s、z分别对应于 ``-C````-F````-L````-R````-S````-Z``
+``-I[cfglrsz]``
+ 对七个准则取反,即筛选出不符合准则的记录。c、f、g、l、r、s、z分别对应于 ``-C````-F````-G````-L````-R````-S````-Z``
示例
----
-筛选与 ``pts.d`` 中所有点的距离在300 km以内,与 ``lines.d`` 中线段的距离在100 km以外的点::
+筛选与 ``pts.txt`` 中所有点的距离在300 km以内,与 ``lines.txt`` 中线段的距离在100 km以外的点::
- gmt select lonlatfile -fg -C300k/pts.d -L100/lines.d -Il > subset
+ gmt select lonlatfile -fg -Cpts.txt+d300k -Llined.txt+d100k -Il > subset
此处需要使用 ``-fg`` 以告知程序正在处理地理数据。
筛选某个区域内所有不在陆地上的点::
- gmt select data.d -R120/121/22/24 -Dh -Nk/s > subset
+ gmt select data.txt -R120/121/22/24 -Dh -Nk/s > subset
-``stations.d`` 中的点投影后与 ``origin.d`` 的距离在5 cm之内的点::
+``stations.txt`` 中的点投影后与 ``origin.txt`` 的距离在5 cm之内的点::
- gmt select stations.d -C5/origin.d -R20/50/-10/20 -JM20c \
+ gmt select stations.txt -C5/origin.d -R20/50/-10/20 -JM20c \
--PROJ_LENGTH_UNIT=cm > subset2
@@ -0,0 +1,6 @@
+.. index:: ! gpsgridder
+
+gpsgridder
+==========
+
+:官方文档: :ref:`gmt:gpsgridder`
View
@@ -3,7 +3,7 @@
grdedit
=======
-:官方文档: :ref:`gmt:grdraster`
+:官方文档: :ref:`gmt:grdedit`
:简介: 修改网格文件的头段或内容
语法
@@ -15,6 +15,9 @@ grdedit
``-A``
如有必要,则对网格间隔做微调使得其与数据的范围相兼容。
+``-C``
+ 从网格文件头段区域中清除GMT命令历史
+
``-D<xname>/<yname>/<zname>/<scale>/<offset>/<invalid>/<title>/<remark>``
修改网格文件的基本信息:
View
@@ -12,7 +12,7 @@ grdimage
``<grid>``
该命令的输入文件必须是2D网格文件,可以是一个只包含Z数据的网格文件,也可以是三个分别包含R、G、B值的网格文件。
-``-A<out_img>=<driver>``
+``-A<out_img>[=<driver>]``
将图片以光栅格式保存
默认图片会以PostScript代码的形式输出。若GMT支持GDAL,则可以使用该选项,将图片以其他光栅格式保存。
@@ -37,7 +37,7 @@ grdimage
``-I<intensfile>|<intensity>``
增加光照效果
- 可以给一个常数值,也可以给一个Z值范围在-1到1的网格文件,通常该网格文件用 ``grdgradient`` 生成。
+ 可以给一个常数值,也可以给一个Z值范围在-1到1的网格文件。通常该强度文件用 ``grdgradient`` 生成,若不指定该强度文件,则GMT会自动调用 ``grdgradient`` 并使用参数 ``-A-45 -Nt1`` 根据输入网格数据生成强度文件
``-M``
使用YIQ转换强制将其转换为灰度图。
View
@@ -94,7 +94,7 @@ grdinfo
$ gmt grdinfo test1.nc -I3/3 -C
1 99 150 -30 30 -10376 6096
-``-L``
+``-L[0|1|2]``
报告Z值的其他信息
- ``-L0`` : 扫描整个数据并报告Z值的范围,而不仅仅只是从网格的头段中读取
@@ -107,15 +107,16 @@ grdinfo
``-R``
从网格文件中取出一个子区域,并报告该子区域的信息
-``-T[s]<dz>``
+``-T<dz>[+a[<alpha>]][+s]``
``-Tzmin/zmax/dz`` 的格式输出Z值范围
#. ``-T<dz>`` :提取Z的最小最大值,并做微调使得最值是dz的整数倍,然后以 ``-Tzmin/zmax/dz`` 的格式输出
- #. ``-Ts<dz>`` : 与上面类似,唯一的区别在于会根据Z的绝对值最大值,输出一个关于0对应的范围
+ #. ``+a<alpha>`` 使用该子选项,则会对网格文件中的值进行排序,并排除两端的部分数据。 ``<alpha>`` 代表要排除的数据的百分比,默认值为2,即排除最小的1%以及最大的1%之后再输出Z值范围
+ #. ``+s`` : 根据Z的绝对最大值,输出一个关于0对称的范围
::
$ gmt grdinfo test1.nc -T0.1
-T-10376/6096/0.1
- $ gmt grdinfo test1.nc -Ts0.1
+ $ gmt grdinfo test1.nc -T0.1+s
-T-10376/10376/0.1
@@ -17,11 +17,12 @@ grdvolume
``-C``
指定等值线(Z值平面)。
- 该选项有三种不同的语法
+ 该选项有四种不同的语法
- ``-C<cval>`` 指定单个等值线
- ``-C<low>/<high>/<delta>`` 指定多条等间距的等值线
- ``-Cr<low>/<high>`` 计算两个Z值平面之间的体积
+ - ``-Cr<cval>`` 指定网格最小值和 ``z=<cval>`` 两条等值线
``-L<base>``
同时也计算从等值线到 ``<base>`` 的体积
View
@@ -1,5 +1,5 @@
-GMT 5.2.1模块列表
-#################
+GMT 5.3.1 模块列表
+##################
欢迎来到 GMT (Generic Mapping Tools) 的世界。
@@ -104,6 +104,7 @@ GMT 5.2.1模块列表
- 计划整理的命令
+ #. :doc:`pssac`
#. :doc:`grdtrack`
#. :doc:`makecpt`
#. :doc:`grd2cpt`
@@ -122,6 +123,7 @@ GMT 5.2.1模块列表
#. :doc:`grdfft`
#. :doc:`splitxyz`
#. :doc:`gmtmath`
+ #. :doc:`pssolar`
- 没有整理计划的命令
@@ -135,6 +137,7 @@ GMT 5.2.1模块列表
#. :doc:`pswiggle`
#. :doc:`grdgravmag3d`
#. :doc:`grdhisteq`
+ #. :doc:`gmtpmodeler`
#. :doc:`grdpmodeler`
#. :doc:`grdredpol`
#. :doc:`grdrotater`
@@ -166,6 +169,7 @@ GMT 5.2.1模块列表
#. :doc:`gmtvector`
#. :doc:`gravfft`
#. :doc:`grdseamount`
+ #. :doc:`gpsgridder`
#. :doc:`grdspotter`
#. :doc:`greenspline`
#. :doc:`gshhg`
@@ -211,6 +215,7 @@ GMT 5.2.1模块列表
gmtinfo
gmtlogo
gmtmath
+ gmtpmodeler
gmtregress
gmtselect
gmtset
@@ -219,6 +224,7 @@ GMT 5.2.1模块列表
gmtswitch
gmtvector
gmtwhich
+ gpsgridder
gravfft
grd2cpt
grd2rgb
@@ -287,9 +293,11 @@ GMT 5.2.1模块列表
psmeca
pspolar
psrose
+ pssac
psscale
pssegy
pssegyz
+ pssolar
pstext
psvelo
pswiggle
View
@@ -24,8 +24,8 @@ psrose
``-B``
``-B`` 选项的介绍。此处,X表示径向距离,Y表示方位角。Y轴的标签是图片的标题。
-``-C[mode_file]``
- 绘制矢量以显示 ``<mode_file>`` 中指定的主方向。若未指定 ``<mode_file>`` 则计算并绘制平均方向。
+``-Cm|<mode_file>``
+ 绘制矢量以显示 ``<mode_file>`` 中指定的主方向。若使用 ``-Cm`` 则计算并绘制平均方向。
``-D``
对扇页对偏移,使得其位于每个间隔的中间,即第一个扇页的中心在0度处
View
@@ -0,0 +1,6 @@
+.. index:: ! pssac
+
+pssac
+=====
+
+:官方文档: :ref:`gmt:pssac`
Oops, something went wrong.

0 comments on commit 15524e6

Please sign in to comment.