Сводка
Вычисляет попарное пересечение входных и стирающих объектов. В выходной класс объектов копируются только те части входных объектов, которые выходят за пределы границ стирающих объектов.
Для выполнения операций стирания доступны и другие инструменты. Изучить подробности можно в документации к инструменту Стирание.
Иллюстрация
Использование
Стирающие объекты могут быть точечными, линейными или полигональными в том случае, если Входные объекты – той же геометрии, или геометрии меньшего порядка. Полигональный стирающий объект может использоваться для стирания полигонов, линий или точек из входных объектов; линейный стирающий объект может использоваться для стирания линий или точек из входных объектов; точечный стирающий объект может использоваться для стирания точек из входных объектов.
Входными объектами должны быть простые пространственные объекты: точки, мультиточки, линии или полигоны. Входные объекты не могут быть сложными, такими как объекты-аннотации, объекты-размеры или сетевые объекты.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.
Внимание:
Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.
Если во входных объектах были кривые, они будут уплотнены в выходных результатах.
Инструмент использует только те входные объекты, которые имеют пространственный индекс. Используйте инструмент Добавить пространственный индекс, чтобы его построить (особенно это касается шейп-файлов) или перестроить уже существующий, чтобы он был абсолютно точен.
Если входные объекты имеют m или z значения, в выходных объектах останутся m и z значения первого класса объектов. Если входные данные не содержат m- или z значения, в выходных данных они также будут отсутствовать.
Пространственная привязка выходного класса объектов будет такой же, как у первого класса объектов в параметре Входные объекты. Более подробную информацию см. в разделе Пространственная привязка и геообработка.
По умолчанию объекты кривых из входных данных будут уплотнены в выходных данных. Для поддержки кривых в выходных данных используйте параметр среды Поддержка сегментов кривой.
Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.
Инструмент Попарное стирание сходен с инструментом Стирание, в котором вычисляются геометрические пересечения объектов, но он существенно отличается подходом, при котором вычисления основаны на парах объектов, а не на всех возможных комбинациях объектов. Инструмент подходит для ситуаций, в которых классы входных и стирающих объектов содержат большое число плотно упакованных объектов.
Синтаксис
arcpy.analysis.PairwiseErase(in_features, erase_features, out_feature_class, {cluster_tolerance})| Parameter | Объяснение | Тип данных |
in_features | Входной класс пространственных объектов или векторный слой. | Feature Layer |
erase_features | Пространственные объекты, которые будут использоваться для стирания совпадающих пространственных объектов в наборах входных данных. | Feature Layer |
out_feature_class | Выходной класс объектов. | Feature Class |
cluster_tolerance (Дополнительный) | Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Пример кода
Пример скрипта окна Python для использования функции PairwiseErase в режиме прямого запуска.
import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.PairwiseErase_analysis(r'redlands.gdb\rdlswells\well',
r'redlands.gdb\rdlsfloodzones\flood',
r'redlands.gdb\wellsoutside_flood')Поиск областей с соответствующим типом растительности с исключением областей, расположенных вблизи от основных магистралей.
# Name: PairwiseErase.py
# Description: Find areas of suitable vegetation that exclude areas heavily
# impacted by major roads.
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/data/Habitat_Analysis.gdb"
# Select suitable vegetation patches from all vegetation
veg = "vegtype"
suitableVeg = "C:/output/Output.gdb/suitable_vegetation"
whereClause = "HABITAT = 1"
arcpy.Select_analysis(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.Buffer_analysis(roads, roadsBuffer, distanceField, "FULL", "ROUND",
"LIST", dissolveField)
# Erase areas of impact around major roads from the suitable vegetation patches
eraseOutput = "C:/output/Output.gdb/suitable_vegetation_minus_roads"
arcpy.PairwiseErase_analysis(suitableVeg, roadsBuffer, eraseOutput)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да