Присоединить (Append) (Управление данными)

Уровень лицензии:BasicStandardAdvanced

Резюме

Присоединяет несколько входных наборов данных к существующему целевому набору данных. Входные наборы данных могут быть точечными, линейными или полигональными классами объектов, таблицами, растрами, каталогами растров, классами объектов аннотаций или классами объетов измерений.

Чтобы комбинировать входные наборы данных в новый выходной набор данных, используйте инструмент Слияние (Merge).

Рисунок

Иллюстрация инструмента Присоединить (Append)

Использование

Синтаксис

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 —Схема входных данных не должна соответствовать схеме целевого набора данных. Поля из входных наборов данных, которые не соответствуют полям целевого набора данных не будут перенесены в целевой набор данных, если соответствие не будет специально определено установкой параметра Список полей (Field Map).
String
field_mapping
(дополнительно)

Контролирует, как информация об атрибутах в полях входных наборов данных переносится в целевой набор данных. Этот параметр может использоваться, только если параметр Тип схемы установлен как NO_TEST.

Поскольку данные входного набора данных присоединяются к существующему целевому набору данных, который имеет предопределенную схему (определения полей), поля нельзя удалить из целевого набора данных или добавить к нему.

Правила слияния позволяют определить, каким образом значения из двух или более входных полей должны сливаться в одно выходное значение. Можно использовать несколько правил слияния:

  • Первое (First) — Заполнение выходного поля значениями из первого поля.
  • Последнее (First) — Заполнение выходного поля значениями из последнего поля.
  • Соединение (Join) — Заполнение выходного поля путем конкатенации (соединения) значений из всех входных полей.
  • Сумма (Sum) — Вычисление суммы значений из всех входных полей.
  • Среднее (Mean) — Вычисление среднего для значений из всех входных полей.
  • Медиана (Median) — Вычисление срединного значения (медианы).
  • Мода (Mode) — Использование значения, встречающегося с наибольшей частотой.
  • Минимум (Min) — Использование наименьшего из всех значений входных полей.
  • Максимум (Max) — Использование наибольшего из всех значений входных полей.
  • Среднеквадратическое отклонение (Standard deviation) — Использование классификации методом среднеквадратического отклонения для всех значений входных полей.
  • Число (Count) — Определение числа записей, входящих в расчет.

Field Mapping
subtype
(дополнительно)

Описание подтипа, которое будет присваивать этот подтип всем новым данным, которые присоединяются к целевому набору данных.

String

Пример кода

Пример инструмента Присоединить (Append) 1 (окно Python)

В следующем скрипте Python продемонстрировано, как использовать инструмент Присоединить (Append) с запуском из окна 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)

На следующем скрипте продемонстрировано, как использовать инструмент Геометрическое соединение (Append).

# 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()

Параметры среды

Связанные темы

Обзор группы инструментов Общие (General)
Присоединить (Покрытие)
Сопоставление входных полей с выходными полями
Выполнить Слияние
Union
Использование параметра соответствия полей
Работа со слоями и представлениями таблиц

Информация о лицензировании

ArcGIS for Desktop Basic: Да
ArcGIS for Desktop Standard: Да
ArcGIS for Desktop Advanced: Да
Информация об авторском праве © Esri, 1995-2013. Все права защищены.
9/10/2013