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

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

Анализирует местоположение координат вершин объектов одного или более классов пространственных объектов. Те, которые окажутся в пределах указанного расстояния друг от друга, считаются представляющими одно и то же местоположение, и им присваивается одинаковое значение координат (т.е. они "схлопываются"). Инструмент также добавляет новые вершины в тех случаях, когда в пределы допуска 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, параллельная обработка не будет включена.

Параметры

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

Классы пространственных объектов, которые будут интегрированы. Если расстояние между элементами мало по сравнению с допуском, вершины или точки будут кластеризованы (перемещены для совпадения).

Value Table
Допуск XY
(Дополнительный)

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

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit

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

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

Обновленные входные объекты.

Feature Layer

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 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.management.CopyFeatures(inFeatures, integrateFeatures)

# Execute Integrate
arcpy.analysis.PairwiseIntegrate(integrateFeatures)

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

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

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