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 ] [ -qflags ] [ -ttransp ] [ --PAR=value ]
必选选项
- -Jx|Xparameters
指定直方图的宽度和高度
- -T[min/max/]inc[+n] |-Tfile|list
指定统计直方
有多种方式可以指定统计直方:
-Tmin/max/inc 指定统计区间的最小值、最大值和直方间隔
-Tinc 只指定统计直方的间隔。统计区别最大和最小值由 -R 选项决定
可选选项
- -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 小于第一个直方的统计范围的数据算入第一个直方
-Lh 大于最后一个直方的统计范围的数据算入最后一个直方
-Lb 小于第一个直方的统计范围的数据算入第一个直方,并且大于最后一个直方的统计范围的数据算入最后一个直方
- -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 等级 [w]
- -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][type][w][+l|b] (more …)
设置二进制输入数据的格式
- -dinodata (more …)
将输入数据中值为 nodata 的列替换为 NaN
- -e[~]“pattern” | -e[~]/regexp/[i] (more …)
筛选或剔除匹配指定模式的数据记录
- -f[i|o]colinfo (more …)
指定输入或输出列的数据类型
- -h[i|o][n][+c][+d][+msegheader][+rremark][+ttitle] (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
示例
访问 绘制直方图 以查看更多示例。