Сводка
Извлекает входные объекты, которые перекрываются вырезающими объектами.
Используйте этот инструмент для вырезания части одного класса объектов по форме одного или нескольких объектов в другом классе, аналогично вырезанию печенья формочкой. Обычно используется для создания нового класса пространственных объектов, также называемого изучаемой областью или областью интереса (AOI), который будет содержать географический поднабор пространственных объектов, скопированный из другого большего класса пространственных объектов.
Для операций вырезания векторных данных доступен другой инструмент. См. инструмент Вырезание.
Иллюстрация
Использование
Для параметра Вырезающие объекты значениями могут быть точки, линии или полигоны, в зависимости от параметра Входных объектов.
- Когда Входные объекты являются полигонами, Вырезающие объекты также должны быть полигонами.
- Когда Входные объекты являются линиями, Вырезающие объекты могут быть линиями или полигонами. При вырезании линейных объектов по форме линейных объектов только совпадающие линии или их сегменты записываются в выходные данные, как показано ниже на рисунке.
- Когда Входные объекты являются точками, Вырезающие объекты могут быть точками, линиями или полигонами. При вырезании точечных объектов по форме точечных же объектов в выходные данные записываются только совпадающие точки, как показано ниже на рисунке. При вырезании точечных объектов по форме линейных объектов в выходные данные записываются только точки, совпадающие с линейными объектами.
Параметр Выходной класс объектов будет содержать все атрибуты параметра Входные объекты.
Линейные объекты вырезаны полигональными объектами:
Точечные объекты вырезаны полигональными объектами:
Линейные объекты вырезаны линейными объектами:
Точечные объекты вырезаны точечными объектами:
Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.
Синтаксис
arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class, {cluster_tolerance})| Parameter | Объяснение | Тип данных |
in_features | Пространственные объекты, к которым будет применена операция вырезания. | Feature Layer |
clip_features | Объекты, используемые для вырезания входных объектов. | Feature Layer |
out_feature_class | Создаваемый класс пространственных объектов. | Feature Class |
cluster_tolerance (Дополнительный) | Минимальное расстояние, в пределах которого координаты объектов считаются различимыми и на которое могут быть смещены координаты по X или Y (или и то, и другое). Установите большее значение для данных с меньшей точностью координат, и меньшее значение - для данных с очень большой точностью. Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Пример кода
Пример скрипта окна Python для использования функции PairwiseClip в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseClip_analysis("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.PairwiseClip_analysis(in_features, clip_features, out_feature_class)Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да