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

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

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

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

# 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"

# Run Pairwise Clip
arcpy.analysis.PairwiseClip(in_features, clip_features, out_feature_class)

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

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

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