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

Краткая информация

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

Используйте этот инструмент для вырезания части одного класса объектов по форме одного или нескольких объектов в другом классе, аналогично вырезанию печенья формочкой. Обычно используется для создания нового класса пространственных объектов, также называемого изучаемой областью или областью интереса (AOI), который будет содержать географический поднабор пространственных объектов, скопированный из другого большего класса пространственных объектов.

Для операций вырезания векторных данных доступен другой инструмент. См. инструмент Вырезание.

Иллюстрация

Иллюстрация инструмента Попарное вырезание

Использование

  • Значениями параметров Вырезать объекты могут быть точки, линии или полигоны, в зависимости от типа геометрии значения параметра Входные объекты.

    • Если значение параметра Входные объекты - полигон, то значением параметра Вырезать объекты также должен быть полигон.
    • Если значение параметра Входные объекты - линия, то значением параметра Вырезать объекты может должен быть линия или полигон. При вырезании линейных объектов по форме линейных объектов только совпадающие линии или их сегменты записываются в выходные данные, как показано ниже на рисунке.
    • Если значение параметра Входные объекты - точка, то значением параметра Вырезать объекты может должен быть точка, линия или полигон. При вырезании точечных объектов по форме точечных же объектов в выходные данные записываются только совпадающие точки, как показано ниже на рисунке. При вырезании точечных объектов по форме линейных объектов в выходные данные записываются только точки, совпадающие с линейными объектами.

  • Параметр Выходной класс объектов будет содержать все атрибуты параметра Входные объекты.

  • Линейные объекты вырезаны полигональными объектами:

    Линейные объекты вырезаны полигональными объектами

  • Точечные объекты вырезаны полигональными объектами:

    Точечные объекты вырезаны полигональными объектами

  • Линейные объекты вырезаны линейными объектами:

    Линейные объекты вырезаны линейными объектами

  • Точечные объекты вырезаны точечными объектами:

    Точечные объекты вырезаны точечными объектами

  • Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (по умолчанию), или задано значение, равное 100, будет включена полная параллельная обработка, и инструмент будет пытаться задействовать все логические ядра процессора компьютера. Установка параметры среды равным 0 отключит параллельную обработку. Присвоение коэффициенту значения от 1 до 99 приведет к тому, что инструмент определит процент логических ядер для использования по формуле (Коэффициент параллельной обработки / 100 * Логические ядра), округлив результат до ближайшего целого значения. Если результат равен 0 или 1, параллельная обработка не будет включена.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Пространственные объекты, к которым будет применена операция вырезания.

Feature Layer
Вырезающие объекты

Объекты, используемые для вырезания входных объектов.

Feature Layer
Выходной класс пространственных объектов

Класс пространственных объектов, который должен быть создан.

Feature Class
Допуск XY
(Дополнительный)

Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y).

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit

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

Пример кода

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

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.PairwiseClip("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.analysis.PairwiseClip(in_features, clip_features, out_feature_class)

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

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

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