Попарное вырезание (Анализ)

Сводка

Извлекает входные объекты, которые перекрываются вырезающими объектами.

Используйте этот инструмент для вырезания части одного класса объектов по форме одного или нескольких объектов в другом классе, аналогично вырезанию печенья формочкой. Обычно используется для создания нового класса пространственных объектов, также называемого изучаемой областью или областью интереса (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

Пример кода

PairwiseClip, пример 1 (окно Python)

Пример скрипта окна Python для использования функции PairwiseClip в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.PairwiseClip_analysis("majorrds.shp", "study_quads.shp", 
                            "C:/output/studyarea.shp")
PairwiseClip, пример 2 (автономный скрипт)

В следующем скрипте 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)

Информация о лицензиях

  • Basic: Да
  • Standard: Да
  • Advanced: Да

Связанные разделы