描述
可将多个输入数据集合并为新的单个输出数据集。此工具可以合并点、线或面要素类或表。
使用追加工具可将输入数据集合并到现有数据集。
插图
使用方法
使用该工具可将多个源中的数据集合并到新的单个输出数据集。所有输入数据集的类型必须相同。例如,点要素类之间可以合并,表之间也可以合并,但线要素类却无法同面要素类合并。
您可以使用字段映射控件来控制输出数据集中所有字段以及各字段中的内容。
该工具不会分割或更改来自输入数据集的几何。即使出现要素重叠,输入数据集中的所有要素在输出数据集中也将保持不变。要合并或打断要素几何,请使用联合工具。
合并要素类时,如果没有设置输出坐标系地理处理环境,则输出数据集将使用输入数据集列表中第一个要素类的坐标系。
此工具不支持注记要素类。使用追加注记要素类工具来合并注记要素类。
此工具不支持栅格数据集。使用镶嵌至新栅格工具可将多个栅格合并为新的输出栅格。
语法
arcpy.management.Merge(inputs, output, {field_mappings})
参数 | 说明 | 数据类型 |
inputs [inputs,...] | 要合并为新的输出数据集的输入数据集。输入数据集可为点、线或面要素类或表。所有输入数据集的类型必须相同。 | Table View |
output | 包含所有合并后输入数据集的输出数据集。 | Feature Class;Table |
field_mappings (可选) | 控制如何将输入数据集中的属性字段映射并传输到输出数据集。 您可添加、重命名或删除输出字段,还可设置诸如数据类型和合并规则等属性。 合并规则用于指定如何将两个或更多个输入字段的值合并或组合为一个输出值。有多种合并规则可用于确定如何用值填充输出字段。
您可使用 ArcPy FieldMappings 类来定义此参数。 | Field Mappings |
代码示例
Merge 示例 1(Python 窗口)
以下 Python 窗口脚本演示了如何使用“合并”工具。
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Merge_management(["majorrds.shp", "Habitat_Analysis.gdb/futrds"], "C:/output/Output.gdb/allroads")
Merge 示例 2(独立脚本)
使用“合并”工具可将两个街区要素类中的要素移动到一个单独的数据集中。
# Name: Merge.py
# Description: Use Merge tool to move features from two street
# feature classes into a single dataset with field mapping
# import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Street feature classes to be merged
oldStreets = "majorrds.shp"
newStreets = "Habitat_Analysis.gdb/futrds"
# 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.Merge_management([oldStreets, newStreets], uptodateStreets, fieldMappings)
环境
许可信息
- Basic: 是
- Standard: 是
- Advanced: 是