Симметричная разность (Symmetrical Difference) (Анализ)
Краткая информация
В выходной класс объектов будут записаны неперекрывающиеся области входных пространственных объектов и корректирующих пространственных объектов.
Рисунок
 |
Использование
-
Входной и корректирующий классы пространственных объектов или слой пространственных объектов должны быть одного типа геометрии.
-
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена на две равные части, атрибутивное значение нового пространственного объекта будет равно половине атрибутивного значения соответствующего входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.
Внимание:Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.
-
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости. Для получения более подробной информации см. Геообработка больших наборов данных.
-
Этот инструмент может создавать составные объекты в выходных данных, даже если все входные данные простые. Если вам не нужны составные объекты, используйте инструмент Составной в простые (Multipart to Singlepart) для выходного класса объектов.
Синтаксис
| Параметр | Объяснение | Тип данных |
in_features |
Входной класс пространственных объектов или слой. | Feature Layer |
update_features |
Класс объектов обновления или слой. Типом геометрии должен быть тот же тип геометрии, который используется для входного класса объектов или слоя. | Feature Layer |
out_feature_class |
Класс пространственных объектов, в который записываются результаты. | Feature Class |
join_attributes (дополнительно) | Определяет, какие атрибуты будут перенесены в выходной класс объектов.
| String |
cluster_tolerance (дополнительно) |
Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). | Linear unit |
Пример кода
На следующем скрипте окна Python показано, как использовать функцию Симметричная разность в окне Python в ArcGIS:
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.SymDiff_analysis("climate.shp", "elevlt250.shp", "C:/output/symdiff.shp", "ALL", 0.001)
На следующем автономном скрипте показано, как использовать функцию Симметричная разность:
# Name: SymDiff_Example2.py
# Description: Create symmetrical difference between input and update features
# Import system modules
import arcpy
from arcpy import env
# Set environment settings
env.workspace = "C:/data"
# Set local variables
inFeatures = "climate.shp"
updateFeatures = "elevlt250.shp"
outFeatureClass = "C:/output/symdiff.shp"
clusterTolerance = 0.001
# Execute SymDiff
arcpy.SymDiff_analysis(inFeatures, updateFeatures, outFeatureClass, "ALL",
clusterTolerance)