Симметричная разность (Анализ)

Доступно с лицензией Advanced.

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

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

Иллюстрация

Иллюстрация инструмента Симметричная разность

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

  • Входной и корректирующий классы пространственных объектов или слой пространственных объектов должны быть одного типа геометрии.

  • Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.

    Внимание:

    Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.

  • Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости.Для получения более подробной информации см. Геообработка больших наборов данных.

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

Параметры

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

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

Feature Layer
Обновленные объекты

Класс объектов обновления или слой. Тип геометрии должен совпадать с типом геометрии входного класса объектов или слоя.

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

Класс пространственных объектов, в который записываются результаты.

Feature Class
Атрибуты для присоединения
(Дополнительный)

Определяет, какие атрибуты будут перемещены в выходной класс объектов.

  • Все атрибутыВсе атрибуты из входных объектов будут перенесены в выходной класс объектов. Это значение по умолчанию
  • Все атрибуты, кроме ID объектовВсе атрибуты, кроме FID, из входных объектов будут перенесены в выходной класс объектов.
  • Только ID объектовВ выходной класс объектов будет скопировано только поле FID из входных объектов.
String
Допуск XY
(Дополнительный)

Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y).

Внимание:

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

Linear Unit

arcpy.analysis.SymDiff(in_features, update_features, out_feature_class, {join_attributes}, {cluster_tolerance})
ИмяОписаниеТип данных
in_features

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

Feature Layer
update_features

Класс объектов обновления или слой. Тип геометрии должен совпадать с типом геометрии входного класса объектов или слоя.

Feature Layer
out_feature_class

Класс пространственных объектов, в который записываются результаты.

Feature Class
join_attributes
(Дополнительный)

Определяет, какие атрибуты будут перемещены в выходной класс объектов.

  • ALLВсе атрибуты из входных объектов будут перенесены в выходной класс объектов. Это значение по умолчанию
  • NO_FIDВсе атрибуты, кроме FID, из входных объектов будут перенесены в выходной класс объектов.
  • ONLY_FIDВ выходной класс объектов будет скопировано только поле FID из входных объектов.
String
cluster_tolerance
(Дополнительный)

Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y).

Внимание:

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

Linear Unit

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.SymDiff("climate.shp", "elevlt250.shp", "C:/output/symdiff.shp", 
                       "ALL", 0.001)
SymDiff, пример 2 (автономный скрипт)

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

# Name: SymDiff_Example2.py
# Description: Create symmetrical difference between input and update features
 
# Import system modules
import arcpy
 
# Set environment settings
arcpy.env.workspace = "C:/data"
 
# Set local variables
inFeatures = "climate.shp"
updateFeatures = "elevlt250.shp"
outFeatureClass = "C:/output/symdiff.shp"
clusterTolerance = 0.001
 
# Execute SymDiff
arcpy.analysis.SymDiff(inFeatures, updateFeatures, outFeatureClass, "ALL",
                       clusterTolerance)

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

Особые случаи

Коэффициент параллельной обработки

Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (используется значение по умолчанию) или указан как 0, параллельная обработка будет отключена. Установка параметра среды на 100 активирует параллельную обработку. Если параллельная обработка включена, используется до 10 ядер.

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

  • Basic: Нет
  • Standard: Нет
  • Advanced: Да

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