创建给定栅格数据集的直方图。

命名空间:  SuperMap.Analyst.SpatialAnalyst
程序集:  SuperMap.Analyst.SpatialAnalyst (in SuperMap.Analyst.SpatialAnalyst)
版本: dll

语法

C#
public static GridHistogram CreateHistogram(
	DatasetGrid sourceDataset,
	int groupCount
)

参数

sourceDataset
Type: SuperMap.Data..::.DatasetGrid
指定的栅格数据集。
groupCount
Type: System..::.Int32
指定的直方图的组数。必须大于 0。

返回值

栅格直方图对象。

备注

直方图,又称柱状图,由一系列高度不等的矩形块来表示一份数据的分布情况。一般横轴表示类别,纵轴表示分布情况。

栅格直方图的横轴表示栅格值的分组,栅格值将被划分到这 N(默认为 100)个组中,即每个组对应着一个栅格值范围;纵轴表示频数,即栅格值在每组的值范围内的单元格的个数。

下图是栅格直方图的示意图。该栅格数据的最小值和最大值分别为 0 和 100,取组数为 10,得出每组的频数,绘制如下的直方图。矩形块上方标注了该组的频数,例如,第 6 组的栅格值范围为 [50,60),栅格数据中值在此范围内的单元格共有 3 个,因此该组的频数为 3。

注:直方图分组的最后一组的值范围为前闭后闭,其余均为前闭后开。

在通过此方法获得栅格数据集的直方图(GridHistogram)对象后,可以通过该对象的 GetFrequencies 方法获取每个组的频数,还可以通过 GroupCount 属性重新指定栅格直方图的组数,然后再通过 GetFrequencies 方法重新获取每组的频数。

下图为创建栅格直方图的一个实例。本例中,最小栅格值为 250,最大栅格值为 1243,组数为 500,获取各组的频数,绘制出如右侧所示的栅格直方图。从右侧的栅格直方图,可以非常直观的了解栅格数据集栅格值的分布情况。

异常

异常条件
System..::.ArgumentExceptiongroupCount 小于或等于 0。

版本信息

SuperMap iObjects .NET


请参见