创建给定栅格数据集的直方图。
命名空间:
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..::.ArgumentException | groupCount 小于或等于 0。 |