格网区域汇总

使用说明

格网区域汇总,即使用规则格网(方形格网或六边形格网)对数据集进行属性汇总(如最大值、总和、均值、方差等),同时可以指定时间周期对象,进行时间维度的属性汇总。返回一个面类型的要素数据集(FeatureRDD)。

不同于【时空格网汇总】的是该方法以权重字段对每个格网单元内线或面要素进行统计,以下图为例进行解释,以四边形网格进行的区域汇总分析,图中高亮显示的网格单元里有两个线对象,线对象A和线对象B。其中线对象A的总长是从A1至A4点,但只有A2至A3部分在网格单元内;线对象B的总长是B1至B3点,但只有B1至B2部分在网格单元内。我们现在对线数据集的“length”字段,进行”sum”统计。

1、 以标准属性字段统计:即对通过网格单元内的线或面对象的原有属性字段信息进行统计。

  • 线对象A的length属性值(即A1至A4点的总长度)为364.11
  • 线对象B的length属性值(即B1至B3点的总长度)为165.01
  • 以“sum”的统计模式进行统计,该网格单元的统计值结果为364.11+165.01=529.12

2、 以权重字段统计:即对通过网格单元内的线或面对象与网格单元相交部分的对象属性信息进行统计,相交部分的属性信息由标准属性字段的值加权计算得出。

  • 分析算法将线对象A在A2点和A3点处打断,计算A2A3部分在整个线对象A中所占的比重,通过线对象A的length属性值(即A1至A4点的总长度)364.11,计算出A2A3的属性值为79.70;
  • 分析算法将线对象B在B2处打断,计算B1B2部分在整个线对象B中所占的比重,通过线对象B的length属性值(即B1至B3点的总长度)165.01,计算出B1B2的属性值为31.72
  • 以“sum”的统计模式进行统计,则该网格单元的统计值结果为79.70+31.72=111.42

SummarizeWithinBins

属性统计字段信息

通过设置属性统计字段信息对格网内的数据进行属性统计,输入格式为srcField,Mode,outField。其中,srcField为输入的数据集中待统计的字段,outField为统计结果字段名,Mode为统计方法,支持的统计方法为:Sum, Min, Max,Average,Variance, VariancePopulation,StdDeviation,StdDeviationPopulation, RecordCount, ModalValue。 如下表所示:

统计方法 含义 统计方法 含义
Sum 求和 Min 最小值
Max 最大值 Average 平均值
Variance 样本方差 VariancePopulation 全样本方差
StdDeviation 样本标准差 StdDeviationPopulation 全样本标准差
ModalValue 众数值统计 RecordCount 记录数目

参数说明

参数名 默认值 参数释义 参数类型
被属性汇总的要素数据集 被属性汇总的要素数据集,支持输入点线面 FeatureRDD
格网类型 格网类型,支持方形格网和蜂窝(六边形)格网,Grid、Hexagon JavaMeshType
网格大小 网格大小,如 1 KiloMeter,对于方格网为方格的边长,对于蜂窝网为六边形顶点到中心点的距离。 JavaDistance
时间周期对象
(可选)
周期时间对象,如果指定周期时间对象,则在 xy 平面维度外增加时间维度进行属性聚合 JavaTimeCycle
要素对象的开始时间字段
(可选)
要素对象的开始时间字段,如果不指定开始时间字段,将会在要素数据集中查找可用的时间字段 String
要素对象的终止时间字段
(可选)
要素对象的终止时间字段,如果不指定终止时间字段,将会在要素数据集中查找可用的时间字段 String
属性统计字段信息
(可选)
属性统计字段信息,输入格式为srcField,Sum,outField,统计方式支持Sum, Min, Max,Average,Variance, VariancePopulation,StdDeviation,StdDeviationPopulation, RecordCount, ModalValue JavaFieldStat
使用权重进行属性统计的字段信息
(可选)
使用权重进行属性统计的字段信息。输入格式与属性统计字段信息相同,与属性统计字段信息必须至少有一个有效。当被汇总对象只有部分区域在汇总对象内部时,会以位于内部的面积/长度比例作为权重,对被汇总对象的属性进行加权统计。只针对线和面类型的被汇总对象。 JavaFieldStat
统计被汇总对象的面积或者长度
(可选)
false 勾选时统计被汇总对象的面积或者长度。只针对被汇总对象为面或者线对象的情形。 Boolean
结果数据集存储汇总对象面积或长度的对象
(可选)
结果数据集存储汇总对象面积或长度的对象。 String
存储的面积的单位
(可选)
SquareKiloMeter 如果被汇总对象是面对象,而且统计被汇总对象的面积,指定存储的面积的单位。 JavaAreaUnit
存储的长度的单位
(可选)
Meter 如果被汇总对象是线对象,而且统计被汇总对象的长度,指定存储的长度的单位。 JavaDistanceUnit