Попарная интеграция (Анализ)

Сводка

Анализирует местоположение координат вершин объектов одного или более классов пространственных объектов. Те, которые окажутся в пределах указанного расстояния друг от друга, считаются представляющими одно и то же местоположение, и им присваивается одинаковое значение координат (т.е. они "схлопываются"). Инструмент также добавляет новые вершины в тех случаях, когда в пределы допуска x,y ребра попадают вершины объекта или в месте пересечения сегментов пространственных объектов.

Попарная интеграция выполняет следующие задачи обработки:

• Вершины, находящиеся друг от друга в пределах допуска x,y, получат одинаковое координатное местоположение.
• Когда вершина одного объекта находится в пределах допуска x,y от ребра другого объекта, на ребре будет добавлена новая вершина.
• При пересечении линейных сегментов в точке пересечения будет добавлена новая вершина для каждого пересекающегося объекта.

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

Иллюстрация

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

Внимание:

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

• Если выбраны входные объекты, этот инструмент будет выполняться только на этих выбранных пространственных объектах.

• Этот инструмент делает то же самое, что и топология, то есть перемещает пространственные объекты в пределах допуска x,y и добавляет вершины, в точках пересечения пространственных объектов. Рассмотрите возможность использования топологии для выполнения такого типа операции, так как топология позволяет задавать правила и условия для взаимоотношений пространственных объектов.

  Используйте инструмент Попарная интеграция вместо топологии в следующих случаях:

  • Вам не нужно задавать правила перемещения пространственных объектов, необходимо только, чтобы все объекты сливались в пределах указанного допуска.
  • Вы хотите, чтобы линии имели вершины в местах пересечения
  • Вы работаете с объектами не базы геоданных, например, шейп-файлами, или с объектами из других баз геоданных (объекты в топологии должны быть из одного набора классов объектов).

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

• Не рекомендуется использовать параметр Допуск XY. Если он не установлен, инструмент проверит пространственную привязку входного класса объектов, чтобы определить допуск x,y, который будет использоваться при интегрировании. Для пространственной привязки входных данных должны быть заданы по умолчанию разрешение x,y и допуск x,y. Для получения дополнительной информации о пространственных привязках см. Свойства пространственной привязки.

  Параметр Допуск XY предназначен не для генерализации геометрии объектов, он предназначен для совмещения линий и границ полигонов в контексте правильно заданной пространственной привязки входного класса пространственных объектов. Установка параметра Допуск XY отличным от значения по умолчанию для входной пространственной привязки может привести к слишком большому или слишком малому перемещению объектов, что приведет к проблемам геометрии. Если используются правильные свойства пространственной привязки, то запуск инструмента Интегрировать может свести к минимуму количество перемещений в данных во время последующих топологических операций (таких как наложение и слияние).

  Значение параметра Допуск XY является критическим. Рекомендуется установить для свойств пространственной привязки входного класса пространственных объектов значения по умолчанию и разрешить Попарную интеграцию по умолчанию в свойствах входного класса пространственных объектов. Дополнительные сведения о кластерной обработке см. в разделе Кластерная обработка.

• Инструмент Попарная интеграция принимает в качестве входных данных только простые классы пространственных объектов (точки, мультиточки, линии или полигоны).

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

• Элемент выходных данных этого инструмента – производные многозначные выходные данные. Чтобы использовать выходные данные этого инструмента в другом инструменте, используйте непосредственно его входные данные, а выходные данные установите в качестве предварительного условия для другого инструмента.

  Подробнее о настройке предварительного условия

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

Синтаксис

arcpy.analysis.PairwiseIntegrate(in_features, {cluster_tolerance})

Parameter	Объяснение	Тип данных
in_features [in_features,...]	Классы пространственных объектов, которые будут интегрированы. Если расстояние между элементами мало по сравнению с допуском, вершины или точки будут кластеризованы (перемещены для совпадения).	Value Table
cluster_tolerance (Дополнительный)	Расстояние, определяющее диапазон, в пределах которого вершины объекта совпадают. Чтобы уменьшить неожиданные перемещения вершин, допуск x,y должен быть достаточно маленьким. Если параметр допуска x,y не задан, значение будет взято из первого входного набора данных. Внимание: Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.	Linear Unit

Производные выходные данные

Name	Объяснение	Тип данных
out_features	Обновленные входные объекты	Векторный слой

Пример кода

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

Пример скрипта окна Python для использования функции PairwiseIntegrate в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.CopyFeatures_management("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.PairwiseIntegrate_analysis("C:/output/output.gdb/vegtype")

PairwiseIntegrate, пример 2 (автономный скрипт)

Пример скрипта Python для выполнения функции PairwiseIntegrate в автономном режиме.

# Description: Run Integrate on a feature class
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# Set local variables
inFeatures = "vegtype"
integrateFeatures = "C:/output/output.gdb/vegtype"
# Execute CopyFeatures (since Integrate modifies the original data, this 
# ensures the original is preserved)
arcpy.CopyFeatures_management(inFeatures, integrateFeatures)
# Execute Integrate
arcpy.PairwiseIntegrate_analysis(integrateFeatures)

Environments

Текущая рабочая область, Экстент, Допуск XY, Коэффициент параллельной обработки

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

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