Сводка
Присоединяет несколько входных наборов данных к существующему целевому набору данных. Входными наборами данных могут быть классы объектов, таблицы, шейп-файлы, растры, классы объектов аннотаций или объекты-размеры.
Чтобы комбинировать входные наборы данных в новый выходной набор данных, используйте инструмент Слияние.
Иллюстрация
Использование
Используйте этот инструмент для добавления новых объектов или других данных из нескольких наборов данных к существующему набору данных. Этот инструмент присоединяет точечные, линейные или полигональные классы объектов, таблицы, растры, классы объектов аннотаций или размеров к существующему набору данных того же типа. Например, несколько таблиц можно присоединить к имеющейся таблице, или несколько растров - к существующему набору растровых данных, но нельзя присоединить класс линейных пространственных объектов к точечному классу.
Параметр Список полей инструмента Присоединить может использоваться для контроля того, как информация из атрибутивных полей входного набора данных переносится в целевой набор данных. Параметр Список полей можно использовать если выбрана опция Сопоставление полей для согласования различий схемы для параметра Тип схемы.
Все поля в выходном наборе данных и содержание этих полей можно контролировать с помощью Списка полей.
- Чтобы изменить порядок полей, выберите имя поля и перетащите его в нужное положение.
- Тип данных по умолчанию для выходного поля будет таким же, как тип данных первого входного поля (того имени), с которым он сталкивается. Вы можете вручную изменить тип данных в любое время на любой другой допустимый тип данных.
- Применимы следующие правила слияния: первый, последний, соединение, сумма, среднее, медиана, мода, минимум, максимум, стандартное отклонение и количество.
- Используя правило слияния Соединение, вы можете задать собственный разделитель, например, пробел, запятую, точку, тире и т.д. Чтобы использовать пробел, убедитесь, что курсор мыши находится в начале входного набора и щелкните клавишу пробел один раз.
- Можно указать начальное и конечное положения текстовых полей, используя опцию формата.
- Среднеквадратическое отклонение не должно быть использовано для одного входного поля, так как значения нельзя делить на ноль. Поэтому среднеквадратическое отклонение не может применяться для одного входного поля.
Этот инструмент не разбивает пространственные объекты в точках пересечений при добавлении их целевому набору данных. Все пространственные объекты из входного класса объектов и целевого класса объектов останутся без изменений после присоединения, даже если пространственные объекты перекрываются. Чтобы скомбинировать, или разбить, геометрию пространственных объектов, используйте инструмент Объединить.
Если для Типа схемы (schema_type = "TEST" в Python) задано Входная схема должна соответствовать целевой, схема (определение полей) входных классов объектов должны совпадать со схемой целевого класса, в который добавляются объекты. Если выбрано Использовать Список полей для согласования различий схемы для Типа схемы (schema_type = "NO_TEST" в Python), схема входного набора данных (определения полей) не должна соответствовать целевому набору данных. Однако поля входных наборов данных, которые не соответствуют полям целевого набора данных, не будут присоединены целевому набору данных, если соответствие не будет специально определено установкой параметра Список полей.
Поскольку данные входных наборов данных записываются в существующий целевой набор данных, который имеет предопределенную схему (названия и типы полей), параметр Список полей не допускает добавления или удаления полей из целевого набора данных.
Если пространственные привязки входного и целевого классов объектов не совпадают, инструмент Присоединить спроецирует пространственные объекты входного класса объектов в систему координат целевого класса объектов.
Этот инструмент не выполняет сопоставление ребер; выравнивание геометрии не производится.
Слои карты могут использоваться как Входные наборы данных. Если в слое задана выборка, то инструмент Присоединить использует только выбранные записи (пространственные объекты или строки таблицы).
Этот инструмент не может использовать несколько входных слоев с одним именем. Чтобы обойти это ограничение, используйте кнопку просмотра диалогового окна инструмента для вывода полных путей каждого из Входных наборов данных.
Чтобы использовать параметр Подтип, целевой набор данных должен иметь заданное поле подтипа и присвоенные коды подтипа. В параметре Подтип задайте описание подтипа, чтобы присвоить этот подтип всем новым данным, которые присоединяются к целевому набору данных.
Синтаксис
arcpy.management.Append(inputs, target, {schema_type}, {field_mapping}, {subtype}, {expression})| Parameter | Объяснение | Тип данных |
inputs [inputs,...] | Входные наборы данных, данные которых будут присоединены к целевым наборам данных. Входные наборы данных могут быть классами точечных, линейных или полигональных объектов, таблицами, растрами, классами объектов аннотаций или классами объектов измерений. Таблицы и классы объектов можно комбинировать. Если класс пространственных объектов добавляется к таблице, атрибуты будут перенесены, но объекты будут удалены. Если таблица присоединяется к классу объектов, строки входной таблицы будут содержать нулевую геометрию. | Table View; Raster Layer |
target | Существующий набор данных, в который будут добавлены данные входных наборов данных. | Table View; Raster Layer |
schema_type (Дополнительный) | Определяет, должны ли поля входного набора присоединяемых данных соответствовать полям целевого набора данных.
| String |
field_mapping (Дополнительный) | Определяет, как атрибутивные поля входного набора данных будут трансформированы или сопоставлены с целевым набором данных. Этот параметр можно использовать только в случае, если для параметра schema_type указано значение NO_TEST. Поскольку входных наборы данных присоединены к существующему целевому набору данных с предопределенной схемой полей, вы не можете добавлять, изменять или удалять типы полей в списке. Вы можете задать правила слияния для каждого выходного поля. Правила слияния позволяют вам определить, каким образом значения из нескольких входных полей будут слиты или объединены в одно выходное значение. Имеется несколько правил слияния, которые можно использовать для определения способа присвоения значений выходным полям.
В Python можно использовать класс FieldMappings для определения этого параметра. | Field Mappings |
subtype (Дополнительный) | Описание подтипа, которое будет присвоено всем новым данным, которые присоединяются к целевому набору данных. | String |
expression (Дополнительный) | SQL-выражение, использованное для выбора поднабора записей входного набора данных. Если указано несколько наборов данных, выражение будет применено ко всем. Если во входном наборе данных отсутствуют записи, удовлетворяющие выражению, ни одна запись не будет присоединена к целевому набору. Более подробно о синтаксисе SQL см. Справочник по SQL для выражений запросов, применяемых в ArcGIS. | SQL Expression |
Производные выходные данные
| Name | Объяснение | Тип данных |
| output | Обновленный целевой набор данных. | Представление таблицы; растровый слой |
Пример кода
Пример скрипта окна Python для использования функции Append в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data/"
arcpy.Append_management(["north.shp", "south.shp", "east.shp", "west.shp"],
"wholecity.shp", "TEST")Скрипт, демонстрирующий выполнение функции Append.
# Name: Append.py
# Description: Use the Append tool to combine several shapefiles
# Import system modules
import arcpy
import os
# Set environment settings
arcpy.env.workspace = "C:/data"
# Set local variables
outLocation = "C:/Output"
outName = "MA_towns.shp"
schemaType = "NO_TEST"
fieldMappings = ""
subtype = ""
# Process: Create a new empty feature class to append shapefiles to
emptyFC = arcpy.CreateFeatureclass_management(outLocation, outName, "POLYGON",
"amherst.shp")
# All polygon FCs in the workspace are MA town shapefiles, you want to append
# these to the empty FC. The list will resemble ["amherst.shp", "hadley.shp",
# "pelham.shp", "coldspring.shp"]
fcList = arcpy.ListFeatureClasses("", "POLYGON")
# Create FieldMappings object to manage merge output fields
fieldMappings = arcpy.FieldMappings()
# Add the target table to the field mappings class to set the schema
fieldMappings.addTable(emptyFC)
# Add input fields for the town name to TOWNNAME field that matches the
# target dataset since each input dataset has a different field name for
# this info
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst.shp","TOWNNAME")
fldMap.addInputField("hadley.shp","NAME")
fldMap.addInputField("pelham.shp","TOWN_NAME")
fldMap.addInputField("coldspring.shp","TOWN")
# Set name of new output field "TOWNNAME"
townName = fldMap.outputField
townName.name, townName.aliasName, townName.type = "TOWNNAME", "TOWNNAME", "TEXT"
fldMap.outputField = townName
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)
# Do the same thing for the POPULATION field
fldMap = arcpy.FieldMap()
fldMap.addInputField("amherst.shp","POPULATION")
fldMap.addInputField("hadley.shp","POP")
fldMap.addInputField("pelham.shp","POP_2010")
fldMap.addInputField("coldspring.shp","POP")
# Set name of new output field "POPULATION"
pop = fldMap.outputField
pop.name, pop.aliasName, pop.type = "POPULATION", "POPULATION", "LONG"
fldMap.outputField = pop
# Add output field to field mappings object
fieldMappings.addFieldMap(fldMap)
# Process: Append the feature classes to the empty feature class
arcpy.Append_management(fcList, os.path.join(outLocation, emptyFC), schemaType,
fieldMappings, subtype)Environments
- Сохранить Global ID
Для инструмента Присоединить этот параметр среды используется только для данных многопользовательских баз геоданных и работает только с данными, содержащими поле Global ID с уникальными индексами. Если у этого поля уникального индекса нет, инструмент может выдать ошибку. Для добавления уникального индекса в поле Global ID можно использовать инструмент Добавить атрибутивный индекс.
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да