clip¶

官方文件:	clip
簡介:	打開或關閉多邊形裁剪路徑

該模塊會從輸入文件中讀取XY數據，由此構成一個或多個多邊形，進而構建出一個或多個裁剪路徑。接下來的所有繪圖命令中，只有在多邊形內部的部分纔會被繪製。

爲了判斷某個點是在裁剪區域內還是在裁剪區域外，clip使用了“奇偶規則”。從任意一點繪製一條任意方向的射線，若該射線穿過裁剪路徑線段奇數次，則該點位於裁剪區域內；若穿過偶數次，則該點位於裁剪區域外。-N 選項可以顛倒內外的定義。

最後，記得再次調用 gmt clip -C 以關閉裁剪區域。

語法¶

gmt clip [ table ] -Jparameters -C[n] -Rwest/east/south/north[/zmin/zmax][+r][+uunit] [ -A[m|p|x|y] ] [ -Bparameters ] -Jz|Zparameters ] [ -N ] [ -T ] [ -U[stamp] ] [ -V[level] ] [ -W[pen] ] [ -X[a|c|f|r][xshift[u]] ] [ -Y[a|c|f|r][xshift[u]] ] [ -bibinary ] [ -dinodata ] [ -eregexp ] [ -fflags ] [ -ggaps ] [ -hheaders ] [ -iflags ] [ -pflags ] [ -ttransp ] [ -:[i|o] ] [ --PAR=value ]

必選選項¶

-C[n]

結束當前裁剪路徑。

默認會關閉所有已開啓的裁剪路徑。使用 -Cn 則僅關閉當前所有處於激活狀態下的裁剪路徑中的其中 n 個。

若在開啓裁剪後有使用 -X 或 -Y 移動過座標原點，則在關閉裁剪路徑時也需要使用 -X 或 -Y 選項。

-Jprojection (more …): 设置地图投影方式。

-Rxmin/xmax/ymin/ymax[+r][+uunit] (more …): 指定数据范围

对于三维透视图 -p，可以加上 /zmin/zmax 指定Z轴的范围。

可選選項¶

table: 一个或多个ASCII或二进制表数据。若不提供表数据，则会从标准输入中读取。

-A[m|p|x|y]

修改兩點間的連接方式

地理投影下，兩點之間默認沿着大圓弧連接。

-A：忽略當前的投影方式，直接用直線連接兩點
-Am：先沿着經線畫，再沿着緯線畫
-Ap：先沿着緯線畫，再沿着經線畫

笛卡爾座標下，兩點之間默認用直線連接。

-Ax 先沿着X軸畫，再沿着Y軸畫
-Ay 先沿着Y軸畫，再沿着X軸畫

-Bparameters (more …): 设置底图边框和轴属性

-N: 反轉“區域內”和“區域外”的概念，即只有在多邊形外的部分纔是裁剪區域，繪圖時只有在多邊形外的纔會被繪製。該選項不能與 -B 選項連用。

-T: 不需要任何輸入數據。根據 -R 選項將整個地圖區域裁剪出來，該選項不能與 -B 選項連用。

-U[label][+c][+jjust][+odx/dy] (more …): 在图上绘制GMT时间戳logo

-V[level] (more …): 设置 verbose 等级 [c]

-Wpen: 繪製裁剪路徑的輪廓 [默認不繪製]

-X[a|c|f|r][xshift[u]]

-Y[a|c|f|r][yshift[u]] (more …): 移动绘图原点

-bi[ncols][t] (more …): 设置二进制输入数据的格式

-dinodata (more …): 将输入数据中值为 nodata 的列替换为 NaN

-e[~]”pattern” | -e[~]/regexp/[i] (more …): 只接受匹配指定模式的数据记录

-f[i|o]colinfo (more …): 指定输入或输出列的数据类型

-g[a]x|y|d|X|Y|D|[col]zgap[u][+n|p] (more …): 确定数据或线段的间断

-h[i|o][n][+c][+d][+rremark][+rtitle] (more …): 跳过或生成指定数目的头段记录

-icols[+l][+sscale][+ooffset][,…][,t[word]] (more …): 设置输入数据列及简单变换（0表示第一列，t 表示文本列）

-p[x|y|z]azim[/elev[/zlevel]][+wlon0/lat0[/z0]][+vx0/y0] (more …): 设置3D透视视角

-t[transp] (more …): 设置图层透明度（百分比）。取值范围为0（不透明）到100（全透明）

-:[i|o] (more …): 交换输入或输出中的第1和第二列。

-^ 或 -: 显示简短的帮助信息，包括模块简介和基本语法信息（Windows下只能使用 -）
-+ 或 +: 显示帮助信息，包括模块简介、基本语法以及模块特有选项的说明
-? 或无参数: 显示完整的帮助信息，包括模块简介、基本语法以及所有选项的说明
--PAR=value: 临时修改GMT参数的值，可重复多次使用。参数列表见 gmt.conf

示例¶

gmt begin clip
# 打開裁剪路徑
gmt clip -R0/6/0/6 -Jx2.5c -W1p,blue << EOF
0 0
5 1
5 5
EOF
# 其他繪圖命令
gmt plot @tut_data.txt -Gred -Sc2c
# 關閉裁剪路徑
gmt clip -C -B
gmt end show

clip¶

語法¶

必選選項¶

可選選項¶

示例¶

相關模塊¶