Permalink
Browse files

updates

  • Loading branch information...
1 parent e00c2b8 commit c4f7f44b9648ecae82e78b55ded5d9357126d568 @seisman seisman committed Nov 24, 2016
Showing with 157 additions and 145 deletions.
  1. +3 −3 generate_docs_inv.py
  2. BIN source/docs.inv
  3. +40 −30 source/gmtselect.rst
  4. +7 −1 source/gmtset.rst
  5. +12 −6 source/grd2xyz.rst
  6. +12 −9 source/grdedit.rst
  7. +6 −5 source/index.rst
  8. +77 −91 source/psbasemap.rst
@@ -14,13 +14,13 @@
# The remainder of this file is compressed with zlib.
'''.encode('utf-8')
-docs = ['configurations', 'embellishments', 'grid-data',
+docs = ['configurations', 'embellishments', 'grid-data',
'vectors',
'cpt', 'text', 'character-escape', 'special-fonts', 'special-characters',
- 'anchors', 'pen', 'lines', 'fill',
+ 'anchors', 'pen', 'lines', 'fill', 'unit',
'option-binary',
- 'option-n',
+ 'option-n',
]
payload_list = []
View
Binary file not shown.
View
@@ -11,9 +11,9 @@ gmtselect
七个空间准则包括:
#. 在矩形区域内( ``-R````-J``
-#. ``ptfile`` 中的每个点的距离在 ``dist`` 之内
-#. ``linefile`` 中的每条线的距离在 ``dist`` 之内
-#. ``polygonfile`` 中的多边形内
+#. 与点文件中的每个点的距离在一定范围之内
+#. 与线文件中的每条线的距离在一定范围之内
+#. 在多边形文件所指定的多边形内
#. 在某个地理区域内(需要海岸线数据)
#. z值在某个范围内
#. 该点所在的网格单元内具有有效值(即非零和非NaN的值)
@@ -22,24 +22,28 @@ gmtselect
------------
准则1
- 筛选出在某个矩形区域内(通过 ``-R````-J`` 选项控制)的点::
++++++
- gmt select points.xy -R0/5/0/5
+使用 ``-R````-J`` 筛选出在该区域内的点::
+
+ gmt select points.xy -R0/5/0/5
准则2
-``<pointfile>`` 中的每个点的距离在 ``<dist>`` 内,由 ``-C`` 选项控制,其语法为::
++++++
- -C<pointfile>+d<dist>[<unit>]
+筛选所有与点文件中的每个点的距离在一定范围内的点。
- 该准则会筛选出与文件 ``<pointfile>`` 中的每个点的距离在 ``<dist>`` 之内的记录。若 ``dist`` 等于0,则 ``<pointfile>`` 中的第三列是每个数据点各自的影响半径,即筛选出不在任何一个数据点的影响半径内的点。
+``-C<pointfile>+d<dist>[<unit>]``
+ 该准则会筛选出与文件 ``<pointfile>`` 中的每个点的距离在 ``<dist>`` 之内的记录。
- 默认情况下 ``<dist>`` 是笛卡尔坐标系下的距离,单位为用户单位。若指定 ``-fg`` 选项,则表明 ``<dist>`` 为球面距离。若使用了 ``-R````-J`` ,则 ``<dist>`` 表示投影后的纸面距离。
+ ``dist`` 等于0,则 ``<pointfile>`` 中的第三列是每个数据点各自的影响半径,即筛选出不在任何一个数据点的影响半径内的点。默认情况下 ``<dist>`` 是笛卡尔坐标系下的距离,单位为用户单位。若指定 ``-fg`` 选项,则表明 ``<dist>`` 为球面距离。若使用了 ``-R````-J`` ,则 ``<dist>`` 表示投影后的纸面距离。
准则3
-``linefile`` 中的每条线的距离在 ``dist`` 之内,由 ``-L`` 选项控制,其语法为::
++++++
- -L<linefile>+d<dist>[<unit>][+p]
+筛选所有与线文件中的每条线的距离在一定范围之内的点。
+``-L<linefile>+d<dist>[<unit>][+p]``
``<linefile>`` 中包含了一系列线段,该准则会筛选出与这些线段的距离不超过 ``<dist>`` 的记录。
``<dist>`` 等于零,则可以在 ``<linefile>`` 中每段数据的段头记录中使用 ``-D<dist>`` 参数,为每个线段分别指定距离值。
@@ -49,46 +53,53 @@ gmtselect
使用 ``+p`` 则会将数据点垂直投影到线段上,只有投影的位置在线段的端点内的记录才会被保留,即只有线段左右一定距离内的点才会被保留,线段两端点一定距离内的点不会被保留。
准则4
- 筛选出在某个多边形内的点,由 ``-F`` 选项控制,其语法为::
++++++
- -F<polygonfile>
+筛选出在某个多边形内的点。
+``-F<polygonfile>``
``<polygonfile>`` 中可以包含一个或多个多边形,该选项筛选出所有在多边形内的记录。
准则5
- 根据地理特征信息筛选数据,由 ``-N````-D`` 选项控制。 ``-N`` 选项的语法为::
-
- -N<wet>/<dry>
++++++
- 或::
+根据地理特征信息筛选数据
- -N<ocean>/<land>/<lake>/<island>/<pond>
+``-D[a|f|h|i|l|c][+]``
+ 选择海岸线数据的精度,仅与 ``-N`` 选项一起使用有效。见 :doc:`pscoast` 中 ``-D`` 选项的介绍。
+``-N<wet>/<dry>``
+``-N<ocean>/<land>/<lake>/<island>/<pond>``
其中每一项都可以取为 ``s|k`` ,分别表示skip或keep,即跳过或保留该地理特征内的记录。默认值为 ``-Ns/k`` ,即保留所有陆地上的记录。
准则6
- 筛选Z值在某个范围内的点,由 ``-Z`` 选项控制。其语法为::
++++++
+
+筛选Z值在某个范围内的点
- -Z<min>[/<max>][+c<col>]
+``-Z<min>[/<max>][+c<col>]``
+ 判断记录的Z值是否在 ``<min>````<max>`` 之间或等于 NaN。
- 判断记录的Z值是否在 ``<min>````<max>`` 之间。可以使用 ``+c<col>`` 指定记录中的某一列作为Z值,默认以第三列(col=2)作为Z值。若省略了 ``<max>`` ,则判断Z值是否等于 ``<min>`` 。若不限制范围的上限或下限,可以使用 ``-`` 代替。
+ 可以使用 ``+c<col>`` 指定记录中的某一列作为Z值,默认以第三列(col=2)作为Z值。若省略了 ``<max>`` ,则判断Z值是否等于 ``<min>`` 。若不限制范围的上限或下限,可以使用 ``-`` 代替。
- 若想要对多列做类似的测试,可以重复使用-Z选项,每次指定不同的列号。
+ 若想要对多列做类似的测试,可以重复使用 ``-Z`` 选项,每次指定不同的列号。
准则7
++++++
+
+根据数据点所在的网格单元内具有有效值(即非零和非NaN的值)来筛选数据。
+
+``-G<gridmask>``
使用 ``-G<gridmask>`` 指定一个网格文件。对于每个数据点而言,判断其对应的网格单元是否具有有效值(即非零或非NaN的值),若该网格单元有有效值,则保留该数据点。
-选项
-----
+其他选项
+--------
``-A``
不考虑面积过小的湖泊的边界,或不考虑某个级别的湖泊边界。见 :doc:`pscoast` 中 ``-A`` 选项的介绍。
-``-D<resolution>[+]``
- 选择海岸线数据的精度,仅与 ``-N`` 选项一起使用有效。见 :doc:`pscoast` 中 ``-D`` 选项的介绍。
-
``-E[fn]``
- 在判断点是否在一个多边形内时,默认会将恰好在多边形上的点也认为是在多边形内,使用该选项会将多边形上的点认为是在多边形外部。 ``f````n`` 分别对应于 ``-F````-N`` 选项
+ 在判断点是否在一个多边形内时,默认会将恰好在多边形边界线上的点也认为是在多边形内,使用该选项会将多边形上的点认为是在多边形外部。 ``f````n`` 分别修改 ``-F````-N`` 选项的行为
``-I[cfglrsz]``
对七个准则取反,即筛选出不符合准则的记录。c、f、g、l、r、s、z分别对应于 ``-C````-F````-G````-L````-R````-S````-Z``
@@ -108,5 +119,4 @@ gmtselect
``stations.txt`` 中的点投影后与 ``origin.txt`` 的距离在5 cm之内的点::
- gmt select stations.txt -C5/origin.d -R20/50/-10/20 -JM20c \
- --PROJ_LENGTH_UNIT=cm > subset2
+ gmt select stations.txt -C5/origin.d -R20/50/-10/20 -JM20c --PROJ_LENGTH_UNIT=cm > subset2
View
@@ -10,6 +10,9 @@ gmtset
若想要参数修改仅对某个命令有效,应该在该命令上使用 ``--<PARAMETER>=<value>`` 语法。
+必须选项
+--------
+
``<PARAMETER>=<value>``
要修改的GMT参数名 ``<PARAMETER>`` 以及想要设置的值 ``<value>``
@@ -23,11 +26,14 @@ gmtset
gmt gmtset FONT_ANNOT_PRIMARY=12p,Helvetica MAP_GRID_CROSS_SIZE_PRIMARY=0.2c
+可选选项
+--------
+
``-C``
将当前目录下的GMT4配置文件 ``.gmtdefaults4`` 转换为GMT5所使用的 ``gmt.conf`` 文件,并保留GMT4配置文件。
``-D[s|u]``
- 默认在当前目录下的配置文件的基础上修改参数值,该选项使得在系统配置文件的基础上修改参数值
+ 默认在当前目录下的配置文件的基础上修改参数值,该选项会基于系统配置文件修改参数值
#. ``-D`` :使用GMT编译过程中指定的默认参数文件,即 ``${GMT}/share/conf/gmt.conf``
#. ``-Du`` :使用US单位制下的默认参数文件,即 ``${GMT}/share/conf/gmt_US.conf``
View
@@ -8,25 +8,31 @@ grd2xyz
该命令或读取一个或多个2D网格文件,并将XYZ数据以ASCII或二进制格式写到标准输出中。ASCII输出的格式由参数 ``FORMAT_FLOAT_OUT`` 控制。
-选项
-----
+必须选项
+--------
``<grid>``
要转换的2D网格文件
+可选选项
+--------
+
``-C[f|i]``
- 输出的X、Y坐标用对应的列、行号替代
+ 输出的XY坐标值用对应的列、行号替代
+
+ 默认输出的三列数据是:X坐标、Y坐标和Z值。使用该选项,则输出的三列数据为:列号、行号和Z值。其中,行号和列号从0开始算起。
- 默认输出的三列数据是:X坐标、Y坐标和Z值。使用该选项,则输出的三列数据为:列号、行号和Z值。其中,行号和列号从0开始算起。 使用 ``-Cf`` 则行号和列号从1开始算起。 ``-Ci`` 会输出两列数据:索引和Z值。索引相当于是将二维数组用一维数组表示。
+ - 使用 ``-Cf`` 则行号和列号从1开始算起
+ - ``-Ci`` 会输出两列数据:索引和Z值。索引相当于是将二维数组用一维数组表示
-``-R``
+``-R<west>/<east>/<south>/<north>``
指定要转换的网格文件的数据范围
``-W[<weight>]``
默认输出XYZ三列数据,使用该选项则输出四列XYZW,其中W即 ``<weight>``
``-Z[flags]``
- 输出一列ASCII表或二进制表。
+ 以 ASCII 或二进制形式输出表数据
使用该选项,则输出时只有Z值,没有XY信息。输出Z值的顺序由 ``<flags>`` 决定。若是行优先, ``<flags>`` 的第一个字符可以取:
View
@@ -6,24 +6,27 @@ grdedit
:官方文档: :ref:`gmt:grdedit`
:简介: 修改网格文件的头段或内容
-语法
-----
+必须选项
+--------
``<grid>``
要修改的网格文件
+可选选项
+--------
+
``-A``
如有必要,则对网格间隔做微调使得其与数据的范围相兼容。
``-C``
- 从网格文件头段区域中清除GMT命令历史
+ 从网格文件头段区域中清除生成该网格所使用的命令信息
``-D<xname>/<yname>/<zname>/<scale>/<offset>/<invalid>/<title>/<remark>``
修改网格文件的基本信息:
- ``<xname>`` X变量名,格式为 ``varname [unit]`` ,比如 ``"distance [km]"``
- - ``<scale>`` 读入网格数据后要乘以的因子
- - ``<offset>`` 读入数据后并乘以因子后要加入的常数
+ - ``<scale>`` 读入网格数据后要乘以的因子,默认值为 1
+ - ``<offset>`` 读入数据后并乘以因子后要加入的常数,默认值为 0
- ``<invalid>`` 无有效值的节点处的替代值,默认为NaN
- ``<title>`` 网格文件的标题
- ``<remark>`` 网格文件的注释信息
@@ -35,9 +38,9 @@ grdedit
gmt grdedit data.nc -R-60/-50/10/30 -D//////"Gravity Anomalies"
``-E[a|h|l|r|t|v]``
- 对网格进行处理
+ 对网格进行处理,该选项与除 ``-G`` 外的其他选项不兼容
- - ``-Ea`` 将网格在180度附近旋转(?)
+ - ``-Ea`` rotate the grid around 180 degrees
- ``-Eh`` 水平旋转网格(从左到右)
- ``-El`` 逆时针将网格旋转90度
- ``-Er`` 顺时针将网格旋转90度
@@ -48,7 +51,7 @@ grdedit
默认情况下,该命令会直接修改并覆盖原始网格文件,使用该选项则将修改后的网格写到新的文件中。
``-N<table>``
- 从文件 ``<table>`` 中读入数据,并用其替换网格中对应节点的值
+ 从文件 ``<table>`` 中读入XYZ数据,并用这些XYZ数据替换网格中对应节点的值
``-R<w>/<e>/<s>/<n>``
修改网格文件的范围。同时,网格间隔会做相应修改。
@@ -61,7 +64,7 @@ grdedit
gmt grdedit world.nc -R-180/180/-72/72 -S
``-T``
- 修改网格文件的头段,将一个网格线配置的文件变成像素配准的文件,或反之。
+ 修改网格文件的头段,将一个网格线配准的文件变成像素配准的文件,或反之。
使用该选项后,网格线配准的数据的范围将在四个方向上扩大半个网格间隔,像素点配置的数据的范围将在四个方向上缩小半个网格间隔。
View
@@ -44,10 +44,12 @@ GMT |version| 模块列表
- :doc:`gmtdefaults` :列出所有GMT参数的当前值
- :doc:`gmtget` :列出单个或多个GMT参数的当前值
+ - :doc:`gmtset` :修改单个或多个GMT参数的值
- :doc:`grdinfo` :从网格文件中提取基本信息
- 绘制 1D 数据
+ - :doc:`psbasemap` :绘制底图
- :doc:`pssolar` :计算或/和绘制晨昏线以及民用、航海用以及天文用曙暮光区域
- :doc:`pssac` :在地图上绘制 SAC 格式的地震波形数据
- :doc:`psclip` :打开或关闭多边形裁剪路径
@@ -59,23 +61,26 @@ GMT |version| 模块列表
- 1D 数据处理
+ - :doc:`gmtselect` :根据多个准则筛选数据
+
- 2D 数据处理
- :doc:`grdpaste` :将两个网格沿着其共同边界拼接成一个文件
- :doc:`grdclip` :对网格文件的Z值做裁剪
- :doc:`grdconvert` :在不同的网格格式之间互相转换
+ - :doc:`grdedit` :修改网格文件的头段或内容
- 格式转换
- :doc:`kml2gmt` :将Google Earth的KML文件转换为GMT表数据
+ - :doc:`grd2xyz` :将网格文件转换成表数据
- :doc:`grdconvert` :在不同的网格格式之间互相转换
**以下模块需要重新检查**
- 绘制1D和2D数据
- - :doc:`psbasemap` :绘制底图
- :doc:`pscoast` :在地图上绘制海岸线、河流、国界线
- :doc:`psxy` :在图上绘制线段、多边形和符号
- :doc:`pstext` :在图上写文本
@@ -92,10 +97,8 @@ GMT |version| 模块列表
- 信息提取
- - :doc:`gmtset` :修改单个或多个GMT参数的值
- :doc:`gmtinfo` :从表数据中提取信息
- :doc:`xyz2grd <gmtinfo>`: 已改名为 ``gmtinfo``
- - :doc:`gmtselect` :根据多个准则筛选数据
- :doc:`gmtwhich` :返回指定文件的完整路径
- :doc:`fitcircle` :拟合球面上数据点的平均位置及圆弧
@@ -109,7 +112,6 @@ GMT |version| 模块列表
- 2D数据处理
- - :doc:`grdedit` :修改网格文件的头段或内容
- :doc:`grdcut` :从一个网格文件中裁剪出一个子区域
- :doc:`grdblend` :将多个部分重叠的网格文件合并成一个网格文件
- :doc:`grdraster` :从二进制数据中提取子区域并保存为GMT网格文件
@@ -124,7 +126,6 @@ GMT |version| 模块列表
- :doc:`psconvert` :将GMT生成的PS文件转换为其他图片格式
- :doc:`ps2raster <psconvert>` :将GMT生成的PS文件转换为其他图片格式
- - :doc:`grd2xyz` :将网格文件转换成表数据
- :doc:`xyz2grd` :将XYZ数据或Z数据转换成网格文件
- :doc:`grd2rgb` :将网格文件、原始RGB文件、SUN光栅文件转换成R/G/B三个网格文件
Oops, something went wrong.

0 comments on commit c4f7f44

Please sign in to comment.