histogram

官方文档: histogram
简介: 统计并绘制直方图

histogram 模块会读取数据中的一列，对其进行统计，并绘制直方图或累积直方图。

语法

必选选项

-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参数的值，可重复多次使用。参数列表见配置参数

示例

访问绘制直方图以查看更多示例。