histogram

官方文件:histogram
簡介:統計並繪製直方圖

模塊會讀取數據中的第一列,對其進行統計,並繪製直方圖或累積直方圖。

語法

gmt histogram [ table ] -Jx|Xparameters -T[min/max/]inc[+n] | -Tfile|list [ -A ] [ -Bparameters ] [ -Ccpt ] [ -D[+b][+ffont][+ooff][+r] ] [ -F ] [ -Gfill ] [ -Jz|Zparameters ] [ -I[o|O] ] [ -Ll|h|b] ] [ -N[mode][+ppen] ] [ -Qr ] [ -Rregion ] [ -S ] [ -U[stamp] ] [ -V[level] ] [ -Wpen ] [ -X[a|c|f|r][xshift[u]] ] [ -Y[a|c|f|r][xshift[u]] ] [ -Z[type][+w] ] [ -bibinary ] [ -dinodata ] [ -eregexp ] [ -fflags ] [ -hheaders ] [ -iflags ] [ -pflags ] [ -ttransp ] [ --PAR=value ]

必選選項

-Jx|Xparameters

-T[min/max/]inc[+n] |-Tfile|list
指定統計對象的最小值min和最大值max

可選選項

-A
繪製水平直方圖,默認繪製垂直直方圖
-Bparameters (more …)
设置底图边框和轴属性
-Ccpt
指定CPT文件,將每個直方的中間值作爲Z值查詢CPT中的顏色
-D[+b][+ffont][+ooff][+r]

爲每個直方(bar)添加標註,其內容是每個直方的統計數目

  • +b 將標註放在直方的底部(默認爲頂部)
  • +ffont 設置標註的字體
  • +ooffset 修改標註與直方的距離(默認值爲6p)
  • +r 將標註從水平方向旋轉爲垂直方向
-F

center bin on each value(默認是左邊界)

假設數據範圍是0到100,長條的寬度爲10。默認情況下,會將0到10作爲第一個bin,10到20作爲第二個bin,以此類推。若使用該選項,則第一個bin以0爲中心,即0到5 是第一個bin,5到15是第二個bin,以此類推。

-Gfill
設置直方的填充色
-I[o|O]

返回計算結果不繪圖。

  • -I 返回 xmin xmax ymin ymax,即數據的最小值、最大值和統計數量的最小值、最大值
  • -Io 輸出各個直方的的X值和Y值
  • -IO 輸出各個直方的的X值和Y值,即使Y=0
-Ll|h|b

設置超過統計範圍的數據的處理方式。

  • -Ll 小於第一個直方的統計範圍的數據算入第一個直方
  • -Ih 大於最後一個直方的統計範圍的數據算入最後一個直方
  • -Ib 小於第一個直方的統計範圍的數據算入第一個直方,並且大於最後一個直方的統計範圍的數據算入最後一個直方
-N[mode][+ppen]

繪製等效的正態分佈曲線

mode 用於設定正態分佈的中間位置及比例:

  • mode=0:平均值和方差 (默認)
  • mode=1:平均值和 L1 範數
  • mode=2:最小二乘

pen 用於指定曲線的屬性。該選項可以使用多次以繪製多條曲線。

-Qr
繪製累計直方圖,r 繪製反向的累計直方圖
-Rxmin/xmax/ymin/ymax[+r][+uunit] (more …)
指定数据范围
对于三维透视图 -p,可以加上 /zmin/zmax 指定Z轴的范围。
-S
繪製階梯狀直方圖,並且不包含直方內部的線條。
-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 …)
移动绘图原点
-Z[type][+w]

選項直方圖的種類

  • type=0:數量(默認值)
  • type=1:百分比
  • type=2:e爲底對數 (1.0 + 數量)
  • type=3:e爲底對數 (1.0 + 百分比)
  • type=4:10爲底對數 (1.0 + 數量)
  • type=5:10爲底對數 (1.0 + 百分比)

若要使用第二列數據而不是count數作爲權重,可以加上 +w 選項。

-bi[ncols][t] (more …)
设置二进制输入数据的格式
-dinodata (more …)
将输入数据中值为 nodata 的列替换为 NaN
-e[~]”pattern” | -e[~]/regexp/[i] (more …)
只接受匹配指定模式的数据记录
-f[i|o]colinfo (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(全透明)
-^-
显示简短的帮助信息,包括模块简介和基本语法信息(Windows下只能使用 -
-++
显示帮助信息,包括模块简介、基本语法以及模块特有选项的说明
-? 或无参数
显示完整的帮助信息,包括模块简介、基本语法以及所有选项的说明
--PAR=value
临时修改GMT参数的值,可重复多次使用。参数列表见 gmt.conf

示例

訪問 繪製直方圖 以查看更多示例。