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

Сводка

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

Иллюстрация

Иллюстрация инструмента Слияние по атрибуту

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

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

  • В выходном классе объектов можно создавать очень большие объекты. Это особенно справедливо, если есть небольшое количество уникальных значений в Поля слияния или при слиянии всех объектов в один. Очень большие объекты могут вызвать проблемы при обработке или отображении, или снизить производительность при прорисовке на карте или при редактировании. Проблемы также могут появиться, если на одном компьютере создан выходной объект максимального размера, затем он переписывается на компьютер с меньшим объемом доступной памяти. Чтобы избежать этих возможных ошибок, отключите опцию Создать составные объекты (multi_part="SINGLE_PART" в Python) для разбиения возможных больших составных объектов на меньшие. Если созданы особенно большие объекты, можно использовать инструмент Нарезать и разбить большие объекты на меньшие, чтобы избежать проблем при обработке, отображении, а также снижения производительности.

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

  • В параметре Поля слияния кнопка Добавить поле используется только в ModelBuilder. В ModelBuilder, где предыдущий инструмент не был запущен или его производные данные не существуют, параметр Поле(я) слияния (Dissolve Field(s)) может не быть заполнен именами поля. Кнопка Добавить поле позволяет вам добавлять нужные поля, так что вы можете закрыть диалоговое окно инструмента и продолжить построение модели.

  • Если тип геометрии Входных объектов является точками или мультиточками, и включена опция Создать составные объекты (в Python установлено значение параметра multi_part="MULTI_PART" MULTI_PART), на выходе будет получен класс мультиточечных объектов. Если же опция Создать мультиточечные объекты не включена (multi_part="SINGLE_PART" в Python), на выходе будет получен класс точечных объектов.

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

Синтаксис

PairwiseDissolve(in_features, out_feature_class, {dissolve_field}, {statistics_fields}, {multi_part})
ParameterОбъяснениеТип данных
in_features

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

Feature Layer
out_feature_class

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

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

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

Кнопка Добавить поле, которая используется только в ModelBuilder, позволяет добавлять ожидаемые поля, так что вы можете закрыть диалоговое окно и продолжить построение модели.

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

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

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

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

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

Укажите, может ли выходной класс объектов содержать составные объекты.

  • MULTI_PARTОзначает, что составные объекты допустимы. Используется по умолчанию.
  • SINGLE_PARTОзначает, что составные объекты недопустимы. Вместо создания составных объектов, для каждой части будут созданы некорректные пространственные объекты.
Boolean

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data/Portland.gdb/Taxlots"
arcpy.PairwiseDissolve_analysis("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"]
 
# Execute MakeFeatureLayer and SelectLayerByAttribute.  This is only to exclude 
#  features that are not desired in the output.
arcpy.MakeFeatureLayer_management(inFeatures, tempLayer)
arcpy.SelectLayerByAttribute_management(tempLayer, "NEW_SELECTION", expression)
 
# Execute Dissolve using LANDUSE and TAXCODE as Dissolve Fields
arcpy.PairwiseDissolve_analysis(tempLayer, outFeatureClass, dissolveFields, "", 
                                "SINGLE_PART")

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

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

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