合并图层 (标准要素分析)

摘要

将两个图层的所有要素复制到一个新图层中。要合并的图层必须包含相同的要素类型(点、线或面)。您可以控制输入图层中各字段的连接和复制方式。

插图

合并图层

使用情况

  • 输入要素必须具有相同的要素类型。

  • 默认情况下,两个输入图层的所有字段都会复制到输出图层。或者,您可以使用合并属性选项重命名、移除和匹配来修改合并图层中的字段。

参数

标注说明数据类型
输入图层

将与合并图层进行合并的点、线或面要素。

Feature Set
合并图层

将与输入图层进行合并的点、线或面要素。合并图层必须包含与输入图层相同的要素类型(点、线或面)。

Feature Set
输出名称

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

String
合并属性
(可选)

用于描述如何修改合并图层中的字段并将其与输入图层中的字段相匹配的值列表。默认情况下,两个输入图层的所有字段都会传递到输出图层中。

如果某个字段存在于一个图层中但不存在于另一个图层中,则输出图层将包含这两个字段。对于不含该字段的输入要素,输出字段中将包含空值。例如,如果输入图层中含有名为 TYPE 的字段,但合并图层中不含有 TYPE,则输出图层中将含有 TYPE,但从合并图层复制的所有要素的 TYPE 值均将为空。

您可以控制以下合并操作(将合并图层上的字段写入输出图层的方式)。

  • 移除 - 合并图层字段将从输出图层中移除。
  • 重命名 - 合并图层字段将在输出中重命名。您无法将合并图层中的字段重命名为输入图层中的字段。如果您希望使字段名保持不变,请使用匹配选项。
  • 匹配 - 系统将重命名合并图层字段并使其与输入图层中的字段进行匹配。例如,输入图层中具有名为 CODE 的字段,同时合并图层中具有名为 STATUS 的字段。可将 STATUSCODE 进行匹配,随后输出中将包含 CODE 字段,其中含有从合并图层复制的要素所用的 STATUS 字段值。系统支持类型转换(例如双精度型至整型、整型至字符串型),字符串型至数字型的转换除外。

Value Table

派生输出

标注说明数据类型
输出

包含来自输入图层和合并图层的合并要素和属性的输出图层。

要素集

arcpy.sfa.MergeLayers(inputLayer, mergeLayer, outputName, {mergingAttributes})
名称说明数据类型
inputLayer

将与合并图层进行合并的点、线或面要素。

Feature Set
mergeLayer

将与输入图层进行合并的点、线或面要素。合并图层必须包含与输入图层相同的要素类型(点、线或面)。

Feature Set
outputName

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

String
mergingAttributes
[[Merge field, Action, Input Field],...]
(可选)

用于描述如何修改合并图层中的字段并将其与输入图层中的字段相匹配的值列表。默认情况下,两个输入图层的所有字段都会传递到输出图层中。

如果某个字段存在于一个图层中但不存在于另一个图层中,则输出图层将包含这两个字段。对于不含该字段的输入要素,输出字段中将包含空值。例如,如果输入图层中含有名为 TYPE 的字段,但合并图层中不含有 TYPE,则输出图层中将含有 TYPE,但从合并图层复制的所有要素的 TYPE 值均将为空。

您可以控制以下合并操作(将合并图层上的字段写入输出图层的方式)。

  • 移除 - 合并图层字段将从输出图层中移除。
  • 重命名 - 合并图层字段将在输出中重命名。您无法将合并图层中的字段重命名为输入图层中的字段。如果您希望使字段名保持不变,请使用匹配选项。
  • 匹配 - 系统将重命名合并图层字段并使其与输入图层中的字段进行匹配。例如,输入图层中具有名为 CODE 的字段,同时合并图层中具有名为 STATUS 的字段。可将 STATUSCODE 进行匹配,随后输出中将包含 CODE 字段,其中含有从合并图层复制的要素所用的 STATUS 字段值。系统支持类型转换(例如双精度型至整型、整型至字符串型),字符串型至数字型的转换除外。

Value Table

派生输出

名称说明数据类型
output

包含来自输入图层和合并图层的合并要素和属性的输出图层。

要素集

环境

特殊情况

许可信息

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

相关主题