范围内汇总 (标准要素分析)

摘要

用于查找另一图层中处于面边界内的点、线或面要素(或要素部分)。

此工具的应用情景示例如下:

  • 针对集水区边界图层和按土地使用类划分的土地使用边界图层,计算每个集水区的土地使用类型的总面积。
  • 针对县内宗地图层和城市边界图层,汇总各城市边界内闲置宗地的平均值。
  • 针对县图层和道路图层,汇总各县内各种道路类型的道路总里程。

插图

“范围内汇总”工具图示

使用情况

  • 您可以将此工具视为使用两个图层,并将其堆叠在彼此上方。 例如,其中一个图层(输入面图层)中的要素均显示为红色。 另一个图层(输入汇总要素)可为任何要素类型 - 点、线或面。 将这些图层堆叠在彼此上方后,您可由上至下对齐堆栈并计算落在具有红色边界的面(输入面)内的输入汇总要素图层中的要素数量。 您不仅能计算要素的数量,也可以计算关于输入汇总要素图层中要素属性的简单统计数据,例如和、平均值、最小值、最大值。

参数

标注说明数据类型
输入面

系统将汇总输入汇总要素参数值中位于上述面边界内的要素或要素部分。

Feature Set
输入汇总要素

将为各输入面汇总的点、线或面要素。

Feature Set
输出名称

要在门户中创建的输出图层的名称。

String
添加形状汇总属性
(可选)

指定是否将根据输入汇总要素参数值(例如每个输入面内输入汇总要素的线的长度或面的面积)的形状计算统计数据。

  • 选中 - 将根据形状汇总属性计算统计数据。 这是默认设置。
  • 未选中 - 不会根据形状汇总属性计算统计数据。

Boolean
形状单位
(可选)

指定将用于形状汇总的单位。

如果输入汇总要素为面,则有效选项为英亩、公顷、平方米、平方千米、平方英尺、平方码和平方英里。

如果输入汇总要素为线,则有效选项为英里、英尺、千米、米和码。

  • 英里单位将为英里。
  • 英尺单位将为英尺。
  • 千米单位将为千米。
  • 单位将为米。
  • 单位将为码。
  • 英亩将以英亩为单位。
  • 公顷单位将为公顷。
  • 平方米单位将为平方米。
  • 平方千米单位将为平方公里。
  • 平方英尺将以平方英尺为单位。
  • 平方码将以平方码为单位。
  • 平方英里将以平方英里为单位。
String
汇总字段
(可选)

字段名称及要为各面内全部点计算的统计汇总类型的列表。 始终返回每个面内的点计数。

支持的统计数据类型如下:

  • 总和 - 将计算总值。
  • 最小值 - 将确定最小值。
  • 最大值 - 将确定最大值。
  • 平均值 - 将计算平均值。
  • 标准差 - 将计算标准差。

Value Table
分组依据字段
(可选)

输入汇总要素的一个字段,将用于分别计算每个唯一属性值的统计数据。 例如,输入汇总要素参数值包含存储危险材料的企业的点位置,且 HazardClass 字段中含有用于描述所存储危险材料类型的代码。 要根据 HazardClass 的每个唯一值计算汇总,请将其用作分组条件字段。

Field
添加少数和众数属性
(可选)

指定是否向输出添加少数和众数字段。

此参数仅当使用按字段分组参数时适用。

  • 未选中 - 不会向输出添加少数和众数字段。 这是默认设置。
  • 选中 - 将对各个边界内每个组字段的少数(所占比例最小)或众数(所占比例最大)属性值进行计算,并将前缀为 Minority_Majority_ 的两个新字段添加至输出。

Boolean
添加组百分比
(可选)

指定是否将组百分比字段添加至输出。

此参数仅当使用按字段分组参数时适用。

  • 未选中 - 不会将百分比字段添加至输出。 这是默认设置。
  • 选中 - 将针对每个输入面计算每个唯一组百分比值,并将百分比字段添加至输出。

Boolean

派生输出

标注说明数据类型
输出要素服务

输出已汇总图层。

Feature Set
输出分组表

如果提供了分组条件字段,则此工具将针对每个唯一组输出含有计算统计数据的表格。

Record Set

arcpy.sfa.SummarizeWithin(sumWithinLayer, summaryLayer, outputName, {sumShape}, {shapeUnits}, {summaryFields}, {groupByField}, {minorityMajority}, {percentShape})
名称说明数据类型
sumWithinLayer

系统将汇总 summaryLayer 参数值中位于上述面边界内的要素或要素部分。

Feature Set
summaryLayer

将为各输入面汇总的点、线或面要素。

Feature Set
outputName

要在门户中创建的输出图层的名称。

String
sumShape
(可选)

指定是否将根据 summaryLayer 参数值(例如每个输入面内输入汇总要素的线的长度或面的面积)的形状计算统计数据。

  • ADD_SHAPE_SUM将根据形状汇总属性计算统计数据。 这是默认设置。
  • NO_SHAPE_SUM不会根据形状汇总属性计算统计数据。
Boolean
shapeUnits
(可选)

指定将用于形状汇总的单位。

如果输入汇总要素为面,则有效选项为英亩、公顷、平方米、平方千米、平方英尺、平方码和平方英里。

如果输入汇总要素为线,则有效选项为英里、英尺、千米、米和码。

  • MILES单位将为英里。
  • FEET单位将为英尺。
  • KILOMETERS单位将为千米。
  • METERS单位将为米。
  • YARDS单位将为码。
  • ACRES将以英亩为单位。
  • HECTARES单位将为公顷。
  • SQUAREMETERS单位将为平方米。
  • SQUAREKILOMETERS单位将为平方公里。
  • SQUAREFEET将以平方英尺为单位。
  • SQUAREYARDS将以平方码为单位。
  • SQUAREMILES将以平方英里为单位。
String
summaryFields
[[Field, Statistic],...]
(可选)

字段名称及要为各面内全部点计算的统计汇总类型的列表。 始终返回每个面内的点计数。

支持的统计数据类型如下:

  • SUM - 将计算总值。
  • MIN - 将确定最小值。
  • MAX - 将确定最大值。
  • MEAN - 将计算平均值。
  • STD - 将计算标准差。

Value Table
groupByField
(可选)

输入汇总要素的一个字段,将用于分别计算每个唯一属性值的统计数据。 例如,summaryLayer 参数值包含存储危险材料的企业的点位置,且 HazardClass 字段中含有用于描述所存储危险材料类型的代码。 要根据 HazardClass 的每个唯一值计算汇总,请将其用作分组条件字段。

Field
minorityMajority
(可选)

指定是否向输出添加少数和众数字段。

此参数仅当使用 groupByField 参数时适用。

  • NO_MIN_MAJ不会向输出添加少数和众数字段。 这是默认设置。
  • ADD_MIN_MAJ将对各个边界内每个组字段的少数(所占比例最小)或众数(所占比例最大)属性值进行计算,并将前缀为 Minority_Majority_ 的两个新字段添加至输出。
Boolean
percentShape
(可选)

指定是否将组百分比字段添加至输出。

此参数仅当使用 groupByField 参数时适用。

  • NO_PERCENT不会将百分比字段添加至输出。 这是默认设置。
  • ADD_PERCENT将针对每个输入面计算每个唯一组百分比值,并将百分比字段添加至输出。
Boolean

派生输出

名称说明数据类型
outputLayer

输出已汇总图层。

Feature Set
groupBySummaryLayer

如果提供了分组条件字段,则此工具将针对每个唯一组输出含有计算统计数据的表格。

Record Set

环境

许可信息

  • Basic: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限
  • Standard: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限
  • Advanced: 需要 ArcGIS Enterprise 中的帐户有执行分析的权限

相关主题