Подпись | Описание | Тип данных |
Входные объекты | Пространственные объекты, к которым будет применена операция вырезания. | Feature Layer |
Вырезающие объекты | Объекты, используемые для вырезания входных объектов. | Feature Layer |
Выходной класс пространственных объектов | Класс пространственных объектов, который должен быть создан. | Feature Class |
Допуск XY (Дополнительный) | Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Краткая информация
Извлекает входные объекты, которые перекрываются вырезающими объектами.
Используйте этот инструмент для вырезания части одного класса объектов по форме одного или нескольких объектов в другом классе, аналогично вырезанию печенья формочкой. Обычно используется для создания нового класса пространственных объектов, также называемого изучаемой областью или областью интереса (AOI), который будет содержать географический поднабор пространственных объектов, скопированный из другого большего класса пространственных объектов.
Для операций вырезания векторных данных доступен другой инструмент. См. инструмент Вырезание.
Иллюстрация
Использование
Значениями параметров Вырезать объекты могут быть точки, линии или полигоны, в зависимости от типа геометрии значения параметра Входные объекты.
- Если значение параметра Входные объекты - полигон, то значением параметра Вырезать объекты также должен быть полигон.
- Если значение параметра Входные объекты - линия, то значением параметра Вырезать объекты может должен быть линия или полигон. При вырезании линейных объектов по форме линейных объектов только совпадающие линии или их сегменты записываются в выходные данные, как показано ниже на рисунке.
- Если значение параметра Входные объекты - точка, то значением параметра Вырезать объекты может должен быть точка, линия или полигон. При вырезании точечных объектов по форме точечных же объектов в выходные данные записываются только совпадающие точки, как показано ниже на рисунке. При вырезании точечных объектов по форме линейных объектов в выходные данные записываются только точки, совпадающие с линейными объектами.
Параметр Выходной класс объектов будет содержать все атрибуты параметра Входные объекты.
Линейные объекты вырезаны полигональными объектами:
Точечные объекты вырезаны полигональными объектами:
Линейные объекты вырезаны линейными объектами:
Точечные объекты вырезаны точечными объектами:
Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.
Параметры
arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class, {cluster_tolerance})
Имя | Описание | Тип данных |
in_features | Пространственные объекты, к которым будет применена операция вырезания. | Feature Layer |
clip_features | Объекты, используемые для вырезания входных объектов. | Feature Layer |
out_feature_class | Класс пространственных объектов, который должен быть создан. | Feature Class |
cluster_tolerance (Дополнительный) | Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Пример кода
В следующем скрипте окна Python показано, как используется функция PairwiseClip в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.PairwiseClip("majorrds.shp", "study_quads.shp",
"C:/output/studyarea.shp")
В следующем скрипте Python показано, как использовать функцию PairwiseClip в автономном скрипте.
# Name: PairwiseClip_Example2.py
# Description: Clip major roads that fall within the study area.
# Import system modules
import arcpy
# Set workspace
arcpy.env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"
# Execute Pairwise Clip
arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да