| Подпись | Описание | Тип данных |
Входные наборы данных |
Входные наборы данных, которые будут объединены в новый выходной набор данных. Входными наборами данных могут быть классы точечных, линейных или полигональных объектов или таблицы. Входные классы пространственных объектов должны быть одного и того же типа геометрии. Таблицы и классы объектов можно комбинировать в один выходной набор данных. Выходной тип определяется первым входным набором данных. Если первый входной набор данных это класс пространственных объектов, то выходные данные будут классом пространственных объектов. Если первый входной набор данных это таблица, то выходные данные будут таблицей. Если таблица присоединяется к классу пространственных объектов, строки из входной таблицы будут иметь пустую геометрию. | 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)