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

摘要

用于查找位于另一个图层面边界范围内的点、线或面要素(或前述部分要素)。

例如

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

插图

范围内汇总图示

使用情况

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

参数

标注说明数据类型
输入面

将汇总落入这些面边界范围内的输入汇总要素中的要素或要素部分。

Feature Set
输入汇总要素

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

Feature Set
输出名称

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

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

根据输入汇总要素的形状计算统计数据,例如各输入面中输入汇总要素线的长度或面的面积。

  • 选中 - 计算形状汇总属性。这是默认设置。
  • 未选中 - 不计算形状汇总属性。

Boolean
形状单位
(可选)

如果要汇总输入汇总要素的形状,请指定形状汇总的单位。

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

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

  • 英里英里
  • 英尺英尺
  • 千米千米
  • 英亩英亩
  • 公顷公顷
  • 平方米平方米
  • 平方千米平方千米
  • 平方英尺平方英尺
  • 平方码平方码
  • 平方英里平方英里
String
汇总字段
(可选)

字段名称及您想要为各面内全部点计算的统计汇总类型的列表。始终返回每个面内的点计数。支持的统计数据类型如下:

  • Sum - 总值。
  • Minimum - 最小值。
  • Max - 最大值。
  • Mean - 平均值。
  • Standard deviation - 标准差。

Value Table
分组条件字段
(可选)

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

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

仅当使用分组条件字段时适用。如果选中,将对各个边界内每个组字段的少数(所占比例最小)或众数(所占比例最大)属性值进行计算。前缀为众数_少数_的两个新字段将添加至输出图层。

  • 未选中 - 不添加少数和众数字段。这是默认设置。
  • 选中 - 添加少数和众数字段。

Boolean
添加组百分比
(可选)

仅当使用分组条件字段时适用。如果选中,则系统将针对每个输入面计算各唯一组值的百分比。

  • 未选中 - 不添加百分比字段。这是默认设置。
  • 选中 - 添加百分比字段。

Boolean

派生输出

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

输出汇总图层。

要素集
输出分组表

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

记录集

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

将汇总落入这些面边界范围内的输入汇总要素中的要素或要素部分。

Feature Set
summaryLayer

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

Feature Set
outputName

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

String
sumShape
(可选)

根据输入汇总要素的形状计算统计数据,例如各输入面中输入汇总要素线的长度或面的面积。

  • 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
(可选)

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

Field
minorityMajority
(可选)

仅当使用分组条件字段时适用。如果指定了 ADD_MIN_MAJ,将对各个边界内每个组字段的少数(所占比例最小)或众数(所占比例最大)属性值进行计算。前缀为众数_少数_的两个新字段将添加至输出图层。

  • NO_MIN_MAJ不添加少数和众数字段。这是默认设置。
  • ADD_MIN_MAJ添加少数和众数字段。
Boolean
percentShape
(可选)

仅当使用分组条件字段时适用。如果选中,则系统将针对每个输入面计算各唯一组值的百分比。

  • NO_PERCENT不添加百分比字段。这是默认设置。
  • ADD_PERCENT添加百分比字段。
Boolean

派生输出

名称说明数据类型
outputLayer

输出汇总图层。

要素集
groupBySummaryLayer

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

记录集

环境

特殊情况

许可信息

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

相关主题