Попарное слияние (Анализ)

Краткая информация

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

Для операций слияния доступен альтернативный инструмент. Дополнительные сведения см. в документации к инструменту Слияние по атрибуту.

Иллюстрация

Рисунок инструмента Попарное слияние

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

  • Атрибуты пространственных объектов, которые были агрегированы путем слияния, могут быть суммированы или описаны с помощью различных статистик. Статистика, используемая для суммирования атрибутов, добавляется к выходному классу объектов как отдельное поле с подчеркиванием и именем входного поля, что является стандартом именования типа статистики. Например, если статистика SUM используется для поля с именем POP, выходные данные будут содержать поле с именем SUM_POP.

  • В выходном классе объектов можно создавать очень большие объекты. Это важно, если в параметре Поля слияния имеется небольшое количество уникальных значений или при слиянии всех объектов в один. Очень большие объекты могут вызвать проблемы при обработке или отображении, или снизить производительность при прорисовке на карте или при редактировании. Проблемы также могут появиться, если на одном компьютере создан выходной объект максимального размера, затем он переписывается на компьютер с меньшим объемом доступной памяти. Чтобы избежать этих возможных ошибок, отключите параметр Создать составные объекты для разбиения возможных больших составных объектов на меньшие. Для особенно больших объектов можно использовать инструмент Нарезать для разбиения больших объектов, чтобы избежать проблем обработки, отображения и производительности.

  • Пустые значения не включаются в расчет статистики. Например, AVERAGE 10, 5 и NULL равно 7.5 ((10+5)/2). Статистика COUNT возвращает количество значений, включенных в статистический расчет, в данном случае это 2.

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

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

  • Инструмент Попарное слияние учитывает Коэффициент параллельной обработки в параметрах среды. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Пространственные объекты, которые будут объединены.

Feature Layer
Выходной класс пространственных объектов

Класс пространственных объектов, который будет содержать агрегированные объекты.

Feature Class
Поля слияния
(Дополнительный)

Поле или поля, по которым будут агрегированы объекты.

Field
Поля статистики
(Дополнительный)

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

По умолчанию инструмент не вычисляет никаких статистических показателей.

Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики.

Доступны следующие типы статистики:

  • Сумма – будут сложены все значения указанного поля.
  • Среднее – будет вычислено среднее значение для указанного поля.
  • Минимум – будет определено наименьшее значение во всех записях указанного поля.
  • Максимум – будет определено наибольшее значение во всех записях указанного поля.
  • Диапазон – будет вычислен диапазон значений (от максимального до минимального) для указанного поля.
  • Стандартное отклонение – будет вычислено среднеквадратическое отклонение для значений в указанном поле.
  • Количество – будет найдено число значений, участвующих в вычислениях. Пересчитываются все значения, исключая пустые значения. Для того чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность.
  • Первое – будет использоваться значение первой записи указанного поля во входных данных.
  • Последнее – будет использоваться значение последней записи указанного поля во входных данных.
  • Медиана – будет вычислена медиана всех записей указанного поля.
  • Дисперсия – будет вычислена дисперсия значений в указанном поле.
  • Уникальные — будет найдено количество уникальных значений в указанном поле.
  • Конкатенация — значения указанного поля будут объединены. Значения можно разделить с помощью параметра Разделитель конкатенации.
Value Table
Создать составной объект
(Дополнительный)

Задает, будут ли включаться составные объекты в выходные данные.

  • Отмечено – составные объекты будут включаться в выходные данные. Это значение по умолчанию
  • Не отмечено – составные объекты не будут включаться в выходные данные. Для каждой части будут создаваться отдельные объекты.
Boolean
Разделитель конкатенации
(Дополнительный)

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

String

arcpy.analysis.PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part}, {concatenation_separator})
ИмяОписаниеТип данных
in_features

Пространственные объекты, которые будут объединены.

Feature Layer
out_feature_class

Класс пространственных объектов, который будет содержать агрегированные объекты.

Feature Class
dissolve_field
[dissolve_field,...]
(Дополнительный)

Поле или поля, по которым будут агрегированы объекты.

Field
statistics_fields
[[field, {statistic_type}],...]
(Дополнительный)

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

По умолчанию инструмент не вычисляет никаких статистических показателей.

Текстовые поля атрибутов могут быть суммированы с помощью первой или последней статистики. Числовые поля атрибутов могут быть суммированы с помощью любой статистики.

Доступны следующие типы статистики:

  • SUM – значения для указанного поля будут суммироваться.
  • MEAN – будет вычислено среднее значение для указанного поля.
  • MIN - будет определено наименьшее значение для всех записей заданного поля.
  • MAX - будет определено наибольшее значение для всех записей заданного поля.
  • RANGE – будет вычислен диапазон значений (от максимального до минимального) для указанного поля.
  • STD - будет вычислено среднеквадратическое отклонение значений в указанном поле.
  • COUNT – будет найдено число значений, участвующих в вычислениях. Пересчитываются все значения, исключая пустые значения. Для того чтобы определить количество пустых значений в поле, вычислите количество значений в этом поле, затем вычислите количество значений в каком-нибудь другом поле, которое не содержит пустых значений (например OID), а затем вычислите их разность.
  • FIRST – будет использоваться значение из первой записи указанного поля во входных данных.
  • LAST – будет использоваться значение из последней записи указанного поля во входных данных.
  • MEDIAN – будет вычислена медиана всех записей указанного поля.
  • VARIANCE – будет вычислена дисперсия значений в указанном поле.
  • UNIQUE — будет посчитано количество уникальных значений в указанном поле.
  • CONCATENATE — значения указанного поля будут объединены. Значения можно разделить с помощью параметра concatenation_separator.
Value Table
multi_part
(Дополнительный)

Задает, будут ли включаться составные объекты в выходные данные.

  • MULTI_PARTСоставные объекты будут включаться в выходные данные. Это значение по умолчанию
  • SINGLE_PARTСоставные объекты не будут включаться в выходные данные. Для каждой части будут создаваться отдельные объекты.
Boolean
concatenation_separator
(Дополнительный)

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

String

Пример кода

PairwiseDissolve, пример 1 (окно Python)

В следующем скрипте окна Python показано, как используется функция PairwiseDissolve в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.analysis.PairwiseDissolve("taxlots", "C:/output/output.gdb/taxlots_dissolved",
                                ["LANDUSE", "TAXCODE"], "", "SINGLE_PART")
PairwiseDissolve, пример 2 (автономный скрипт)

В следующем автономном скрипте показано использование функции PairwiseDissolve.

# Name: PairwiseDissolve_Example2.py
# Description: Dissolve features based on common attributes
 
# Import system modules
import arcpy

arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
 
# Set local variables
inFeatures = "taxlots"
tempLayer = "taxlotsLyr"
expression = arcpy.AddFieldDelimiters(inFeatures, "LANDUSE") + " <> ''"
outFeatureClass = "C:/output/output.gdb/taxlots_dissolved"
dissolveFields = ["LANDUSE", "TAXCODE"]
 
# Run MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude 
#  features that are not desired in the output.
arcpy.management.MakeFeatureLayer(inFeatures, tempLayer)
arcpy.analysis.SelectLayerByAttribute(tempLayer, "NEW_SELECTION", expression)
 
# Run Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.analysis.PairwiseDissolve(tempLayer, outFeatureClass, dissolveFields, "", 
                                "SINGLE_PART")

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

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы