Подпись | Описание | Тип данных |
Входные объекты | Входной класс пространственных объектов или векторный слой. | Feature Layer |
Стирающие объекты | Пространственные объекты, которые будут использоваться для стирания совпадающих пространственных объектов в наборах входных данных. | Feature Layer |
Выходной класс пространственных объектов | Класс пространственных объектов, который будет содержать только те входные объекты, которые не совпадают со стирающими объектами. | Feature Class |
Допуск XY (Дополнительный) | Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Доступно с лицензией Advanced.
Краткая информация
Создает класс пространственных объектов путем наложения входных объектов и стирающих объектов. В выходной класс объектов копируются только те части входных объектов, которые выходят за границы стирающих полигонов.
Для выполнения операций стирания доступны и другие инструменты. См. справку по инструменту Попарное стирание для подробной информации.
Иллюстрация
Использование
Геометрии, совпадающие у Входные объектов и Стирающих объектов, будут удалены.
Стирающие объекты могут быть точечными, линейными или полигональными в том случае, если Входные объекты – той же геометрии, или геометрии меньшего порядка. Полигональный стирающий объект может использоваться для стирания полигонов, линий или точек из входных объектов; линейный стирающий объект может использоваться для стирания линий или точек из входных объектов; точечный стирающий объект может использоваться для стирания точек из входных объектов.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.
Внимание:
Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости.Для получения более подробной информации см. Геообработка больших наборов данных.
Этот инструмент может создать составные объекты выходных данных, даже если все входные объекты состоят из одной части. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.
Параметры
arcpy.analysis.Erase(in_features, erase_features, out_feature_class, {cluster_tolerance})
Имя | Описание | Тип данных |
in_features | Входной класс пространственных объектов или векторный слой. | Feature Layer |
erase_features | Пространственные объекты, которые будут использоваться для стирания совпадающих пространственных объектов в наборах входных данных. | Feature Layer |
out_feature_class | Класс пространственных объектов, который будет содержать только те входные объекты, которые не совпадают со стирающими объектами. | Feature Class |
cluster_tolerance (Дополнительный) | Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Пример кода
В следующем скрипте окна Python показано, как используется функция Erase в режиме прямого запуска.
import arcpy
arcpy.env.workspace = 'C:/data/gdb'
arcpy.analysis.Erase(r'redlands.gdb\rdlswells\well',
r'redlands.gdb\rdlsfloodzones\flood',
r'redlands.gdb\wellsoutside_flood')
Поиск областей с соответствующим типом растительности с исключением областей, расположенных вблизи от основных магистралей.
# Name: Erase.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.analysis.Select(veg, suitableVeg, whereClause)
# Buffer areas of impact around major roads
roads = "majorrds"
roadsBuffer = "C:/output/Output.gdb/buffer_output"
distanceField = "Distance"
dissolveField = "Distance"
arcpy.analysis.Buffer(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.analysis.Erase(suitableVeg, roadsBuffer, eraseOutput)
Параметры среды
Особые случаи
- Коэффициент параллельной обработки
Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (используется значение по умолчанию) или указан как 0, параллельная обработка будет отключена. Установка параметра среды на 100 активирует параллельную обработку. Если параллельная обработка включена, используется до 10 ядер.
Параллельная обработка на данном этапе поддерживается для операций наложения полигон на полигон, линия на полигон и точка на полигон.
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да