标注 | 说明 | 数据类型 |
输入数据集 |
要合并为新的输出数据集的输入数据集。 输入数据集可为点、线或面要素类或表。 输入要素类必须具有相同的几何类型。 可将表和要素类组合成单个输出数据集。 输出类型由第一个输入确定。 如果第一个输入为要素类,则输出将为要素类。 如果第一个输入为表,则输出将为表。 如果将表合并到要素类中,则输入表中的行将具有空几何。 | Table View |
输出数据集 | 将包含所有合并输入数据集的输出数据集。 | Feature Class;Table |
字段映射 (可选) | 使用字段映射来协调多个数据集之间的方案差异并匹配属性字段。 默认情况下,输出包括来自输入数据集的所有字段。 使用字段映射来添加、删除、重命名和重新排序字段,以及更改其他字段属性。 字段映射还可以用于将两个或多个输入字段的值合并为单个输出字段。 | Field Mappings |
将源信息添加至输出 (可选) |
指定是否将源信息添加到输出数据集的新 MERGE_SRC 文本字段中。 MERGE_SRC 字段中的值将指示输入数据集路径或图层名称,即输出中每条记录的来源。
| Boolean |
插图
使用情况
使用该工具可将多个源中的数据集合并到新的单个输出数据集。 输入要素类必须具有相同的几何类型。 例如,点要素类之间可以合并,但线要素类却无法同面要素类合并。
可将表和要素类组合成单个输出数据集。 输出类型由第一个输入确定。 如果第一个输入为要素类,则输出将为要素类。 如果第一个输入为表,则输出将为表。 如果将表合并到要素类中,则输入表中的行将具有空几何。
使用字段映射参数管理输出数据集中的字段及其内容。
- 您可以向字段列表中添加和移除字段,重新排序字段列表,并重命名字段。
- 输出字段的默认数据类型与它遇到的第一个输入字段(具有相同名称的字段)的数据类型相同。 可以将数据类型更改为其他有效的数据类型。
- 使用操作确定如何将一个或多个输入字段的值合并到单个输出字段中。 可用的操作包括第一个、最后一个、串连、求和、平均值、中位数、众数、最小值、最大值、标准差和计数。
- 当使用串连操作时,可以指定分隔符,例如逗号或其他字符。 单击分隔符文本框的开始部分以添加分隔符。
- 单个输入值不支持标准差选项。
- 对于文本源字段,使用分割文本按钮,可以选择从输入值中提取到输出字段的字符。 要访问分割文本按钮,需将鼠标悬停在输入字段列表中的文本字段上,然后指定起始和结束字符位置。
- 还可以使用 Python 脚本映射字段。
该工具不会分割或更改来自输入数据集的几何。 即使出现要素重叠,输入数据集中的所有要素在输出数据集中也将保持不变。 要合并或打断要素几何,请使用联合工具。
合并要素类时,如果没有设置输出坐标系地理处理环境,则输出数据集将使用输入数据集列表中第一个要素类的坐标系。
此工具不支持注记要素类。 使用追加注记要素类工具来合并注记要素类。
此工具不支持栅格数据集。 使用镶嵌至新栅格工具可将多个栅格组合为新的输出栅格。
参数
arcpy.management.Merge(inputs, output, {field_mappings}, {add_source})
名称 | 说明 | 数据类型 |
inputs [inputs,...] |
要合并为新的输出数据集的输入数据集。 输入数据集可为点、线或面要素类或表。 输入要素类必须具有相同的几何类型。 可将表和要素类组合成单个输出数据集。 输出类型由第一个输入确定。 如果第一个输入为要素类,则输出将为要素类。 如果第一个输入为表,则输出将为表。 如果将表合并到要素类中,则输入表中的行将具有空几何。 | Table View |
output | 将包含所有合并输入数据集的输出数据集。 | Feature Class;Table |
field_mappings (可选) | 使用字段映射来协调多个数据集之间的方案差异并匹配属性字段。 默认情况下,输出包括来自输入数据集的所有字段。 使用字段映射来添加、删除、重命名和重新排序字段,以及更改其他字段属性。 字段映射还可以用于将两个或多个输入字段的值合并为单个输出字段。 在 Python 中,使用 FieldMappings 类来定义此参数。 | Field Mappings |
add_source (可选) | 指定是否将源信息添加到输出数据集的新 MERGE_SRC 文本字段中。 MERGE_SRC 字段中的值将指示输入数据集路径或图层名称,即输出中每条记录的来源。
| Boolean |
代码示例
以下 Python 窗口脚本演示了如何使用 Merge 函数。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.Merge(["majorrds.shp", "Habitat_Analysis.gdb/futrds"],
"C:/output/Output.gdb/allroads", "", "ADD_SOURCE_INFO")
使用 Merge 函数可将两个街区要素类中的要素移动到一个单独的数据集中。
# Name: Merge.py
# Description: Use Merge to move features from two street
# feature classes into a single dataset with field mapping
# import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data"
# Street feature classes to be merged
oldStreets = "majorrds.shp"
newStreets = "Habitat_Analysis.gdb/futrds"
addSourceInfo = "ADD_SOURCE_INFO"
# Create FieldMappings object to manage merge output fields
fieldMappings = arcpy.FieldMappings()
# Add all fields from both oldStreets and newStreets
fieldMappings.addTable(oldStreets)
fieldMappings.addTable(newStreets)
# Add input fields "STREET_NAM" & "NM" into new output field
fldMap_streetName = arcpy.FieldMap()
fldMap_streetName.addInputField(oldStreets, "STREET_NAM")
fldMap_streetName.addInputField(newStreets, "NM")
# Set name of new output field "Street_Name"
streetName = fldMap_streetName.outputField
streetName.name = "Street_Name"
fldMap_streetName.outputField = streetName
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap_streetName)
# Add input fields "CLASS" & "IFC" into new output field
fldMap_streetClass = arcpy.FieldMap()
fldMap_streetClass.addInputField(oldStreets, "CLASS")
fldMap_streetClass.addInputField(newStreets, "IFC")
# Set name of new output field "Street_Class"
streetClass = fldMap_streetClass.outputField
streetClass.name = "Street_Class"
fldMap_streetClass.outputField = streetClass
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap_streetClass)
# Remove all output fields from the field mappings, except fields
# "Street_Class", "Street_Name", & "Distance"
for field in fieldMappings.fields:
if field.name not in ["Street_Class", "Street_Name", "Distance"]:
fieldMappings.removeFieldMap(fieldMappings.findFieldMapIndex(field.name))
# Since both oldStreets and newStreets have field "Distance", no field mapping
# is required
# Use Merge tool to move features into single dataset
uptodateStreets = "C:/output/Output.gdb/allroads"
arcpy.management.Merge([oldStreets, newStreets], uptodateStreets, fieldMappings,
addSourceInfo)