追加 (Data Management)

许可等级:BasicStandardAdvanced

摘要

将多个输入数据集追加到现有目标数据集。输入数据集可以是点、线、面要素类、表、栅格、栅格目录、注记要素类或尺寸要素类。

要将输入数据集合并到新的输出数据集中,请使用合并工具。

插图

Append illustration

用法

语法

Append_management (inputs, target, {schema_type}, {field_mapping}, {subtype})
参数说明数据类型
inputs
[inputs,...]

数据将被追加到目标数据集的输入数据集。输入数据集可以是点、线、面要素类、表、栅格、栅格目录、注记要素类或尺寸要素类。各输入数据集的数据类型必须与目标数据集的数据类型相匹配。

Table View; Raster Layer
target

将追加输入数据集数据的现有数据集。各输入数据集的数据类型必须与目标数据集的数据类型相匹配。

Table View; Raster Layer
schema_type
(可选)

指定输入数据集的方案(字段定义)是否必须与目标数据集的方案相匹配才能追加要素。

  • TEST输入数据集的方案(字段定义)必须与目标数据集的方案相匹配。如果方案不匹配,将返回错误。
  • NO_TEST输入数据集的方案(字段定义)不必与目标数据集的方案相匹配。但是,如果输入数据集的字段与目标数据集的字段不匹配,将不会被映射到目标数据集,除非在“字段映射”控件中对映射进行了显式设置。
String
field_mapping
(可选)

控制如何将输入数据集字段中的属性信息传输到目标数据集。只有在指定方案类型 NO_TEST 的情况下,才能使用这个参数。

由于输入数据集的数据被追加到具有预定义方案(字段定义)的现有目标数据集中,因此不允许在目标数据集中添加或移除字段。

合并规则用于指定如何将两个或更多个输入字段的值合并为一个输出值。有以下几个合并规则可供使用:

  • First - 使用第一个输入字段的值填充输出字段。
  • Last - 使用最后一个输入字段的值填充输出字段。
  • Join - 串连(连接)所有输入字段的值以填充输出字段。
  • Sum - 计算所有输入字段值的总和。
  • Mean - 计算所有输入字段值的平均值。
  • Median - 计算中值。
  • Mode - 使用具有最高频率的值。
  • Min - 使用所有输入字段值中的最小值。
  • Max - 使用所有输入字段值中的最大值。
  • Standard deviation - 对所有输入字段值使用标准差分类方法。
  • Count - 查找计算中所包含的记录数。

Field Mapping
subtype
(可选)

用于将子类型分配给已追加到目标数据集中的所有新数据的子类型描述。

String

代码实例

Append 示例 1(Python 窗口)

以下 Python 窗口脚本演示了如何在即时模式下使用“追加”工具。

import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"], "wholecity.shp", "TEST","","")
Append 示例 2(独立 Python 脚本)

以下脚本演示了如何使用“追加”工具。

# Name: Append.py
# Description: Use the Append tool to combine several shapefiles


# import system modules 
import arcpy, os
from arcpy import env

# Set environment settings
env.workspace = "C:/data"

# Set local variables
outLocation = "C:/Output"
emptyFC = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""

try:
    # Process:  Create a new empty feature class to append shapefiles into
    arcpy.CreateFeatureclass_management(outLocation, emptyFC, "POLYGON", "amherst.shp")

    # All polygon FCs in the workspace are MA town shapefiles, we want to append these to the empty FC
    fcList = arcpy.ListFeatureClasses("","POLYGON")
    # list will resemble ["amherst.shp", "hadley.shp", "pelham.shp", "coldspring.shp"] 

    # Process: Append the feature classes into the empty feature class
    arcpy.Append_management(fcList, outLocation + os.sep + emptyFC, schemaType, fieldMappings, subtype)

except:
    # If an error occurred while running a tool print the messages
    print arcpy.GetMessages()

环境

相关主题

许可信息

ArcGIS for Desktop Basic: 是
ArcGIS for Desktop Standard: 是
ArcGIS for Desktop Advanced: 是
5/10/2014