描述
用于查找位于另一个图层面边界范围内的点、线或面要素(或前述部分要素)。
例如
- 按土地使用类型给定分水岭边界图层和土地使用边界图层,计算每个分水岭的土地使用类型的总面积。
- 给定一个县内宗地的图层和城市边界图层,汇总各城市边界内闲置宗地的平均值。
- 给定各县的图层和道路图层,汇总各县内各种道路类型的道路总里程。
插图
使用方法
您可以将范围内汇总视为使用两个图层,并将其堆叠在彼此上方。假设其中一个图层(输入面图层)中的要素均显示为红色。另一个图层(输入汇总要素)可为任何要素类型 - 点、线或面。将这些图层堆叠在彼此上方后,您可由上至下对齐堆栈并计算落在具有红色边界的面(输入面)内的输入汇总要素图层中的要素数量。您不仅能计算要素的数量,也可以计算关于输入汇总要素图层中要素属性的简单统计数据,例如和、平均值、最小值、最大值。
语法
arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
参数 | 说明 | 数据类型 |
sumWithinLayer | 将汇总落入这些面边界范围内的输入汇总要素中的要素或要素部分。 | Feature Set |
summaryLayer | 将为各输入面汇总的点、线或面要素。 | Feature Set |
outputName | 要在门户中创建的输出图层的名称。 | String |
sumShape (可选) | 根据输入汇总要素的形状计算统计数据,例如各输入面中输入汇总要素线的长度或面的面积。
| Boolean |
shapeUnits (可选) | 如果要汇总输入汇总要素的形状,请指定形状汇总的单位。 如果输入汇总要素为面,则有效选项为英亩、公顷、平方米、平方千米、平方英尺、平方码和平方英里。 如果输入汇总要素为线,则有效选项为米、千米、英尺、码和英里。
| String |
summaryFields [[Field, Statistic],...] (可选) | 字段名称及您想要为各面内全部点计算的统计汇总类型的列表。始终返回每个面内的点计数。支持的统计数据类型如下:
| Value Table |
groupByField (可选) | 这是输入汇总要素的一个字段,可用于分别计算每个唯一属性值的统计数据。例如,假设输入汇总要素包含存储危险材料的企业的点位置,且其中一个字段为 HazardClass,字段中含有用于描述所存储危险材料类型的代码。要根据每个 HazardClass 唯一值计算汇总,请将其用作分组条件字段。 | Field |
minorityMajority (可选) | 仅当使用分组条件字段时适用。如果指定了 ADD_MIN_MAJ,将对各个边界内每个组字段的少数(所占比例最小)或众数(所占比例最大)属性值进行计算。前缀为众数_和少数_的两个新字段将添加至输出图层。
| Boolean |
percentShape (可选) | 仅当使用分组条件字段时适用。如果选中,则系统将针对每个输入面计算各唯一组值的百分比。
| Boolean |
派生输出
名称 | 说明 | 数据类型 |
outputLayer | 输出汇总图层。 | 要素集 |
groupBySummaryLayer | 如果提供了分组条件字段,则此工具将针对每个唯一组输出含有计算统计数据的表格。 | 记录集 |
环境
许可信息
- Basic: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限
- Standard: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限
- Advanced: 需要 Portal for ArcGIS 中的ArcGIS Enterprise 中的帐户有执行分析的权限