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

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

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

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

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

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

Иллюстрация

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

Внимание:

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

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

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

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

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

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

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

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

  Более подробно о кластеризации

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

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

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

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

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

Параметры

Диалог

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

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

Подпись	Описание	Тип данных
Обновленные входные объекты	Обновленные входные объекты.	Feature Layer

Python

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

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

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

Имя	Описание	Тип данных
out_features	Обновленные входные объекты.	Feature Layer

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.management.CopyFeatures("Habitat_Analysis.gdb/vegtype", "C:/output/output.gdb/vegtype")
arcpy.analysis.PairwiseIntegrate("C:/output/output.gdb/vegtype")

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

Следующий автономный скрипт является примером применения функции PairwiseIntegrate в среде скриптов.

# Description: Run PairwiseIntegrate 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"

# Run CopyFeatures (since PairwiseIntegrate modifies the original data, this 
# ensures the original is preserved)
arcpy.management.CopyFeatures(inFeatures, integrateFeatures)

# Run PairwiseIntegrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

Параметры среды

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

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

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