Вырезать (Инструменты Анализа)

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

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

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

Операции вырезания также могут быть выполнены с помощью инструмента Попарное вырезание.

Иллюстрация

Иллюстрация инструмента Вырезать

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

Для параметра Вырезающие объекты значениями могут быть точки, линии или полигоны, в зависимости от типа параметра Входные объекты или набор данных.
- Когда значения для Входные объекты или набор данных являются полигонами, значения для Вырезающие объекты также должны быть полигонами.
- Когда значения для Входные объекты или набор данных являются линиями, значения для Вырезающие объекты могут быть линиями или полигонами. При вырезании линейных объектов по форме линейных объектов только совпадающие линии или их сегменты записываются в выходные данные, как показано ниже на рисунке.
- Когда значения для Входные объекты или набор данных являются точками, значения для Вырезающие объекты могут быть точками, линиями или полигонами. При вырезании точечных объектов по форме точечных же объектов в выходные данные записываются только совпадающие точки, как показано ниже на рисунке. При вырезании точечных объектов по форме линейных объектов в выходные данные записываются только точки, совпадающие с линейными объектами.
- Если значения параметра Входные объекты или набор данных являются интегрированной моделью mesh, точкой, зданием, 3D-объектом или облаком точек, слоем сцены или пакетом слоя сцены интегрированной модели mesh, значения для Вырезающие объекты также должны быть полигонами.
Параметр Выходные объекты или набор данных будет содержать все атрибуты значения параметра Входные объекты или набор данных, если выходные данные являются классом объектов.
Пакеты слоя сцены Интегрированная модель mesh, Точка, Здание и 3D-объект и сервисы сцены должны использовать I3S версии 1.6 или выше, чтобы его можно было использовать в качестве входных данных. Используйте инструмент Обновить слой сцены для обновления пакетов слоев сцены версии 1.5 или более ранних версий. Выходной пакет слоя сцены будет в последней версии I3S.
Сервисы сцен должны иметь возможность извлечения, чтобы их можно было вырезать. Сервисы без этой возможности будут заблокированы в качестве входных данных.
Если входные данные - слой зданий сцены, будут вырезаны все категории и слои дисциплины. Если входные данные являются слоем категорий, выходной пакет слоев сцены будет пакетом слоев 3D-объектов сцены с только одним выбранным слоем.
Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.
Линейные объекты вырезаны полигональными объектами:
Точечные объекты вырезаны полигональными объектами:
Линейные объекты вырезаны линейными объектами:
Точечные объекты вырезаны точечными объектами:
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой, и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции, всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Опция Использовать правило пропорции применяется только к числовым типам полей.

Внимание:

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

Подпись	Объяснение	Тип данных
Входные объекты или набор данных	Объекты для вырезания.	Feature Layer; Scene Layer; File; Building Scene Layer
Вырезающие объекты	Пространственные объекты, которые будут использованы для вырезания входных объектов.	Feature Layer
Выходные объекты или набор данных	Набор данных, который будет создан.	Feature Class; File
Допуск XY (Дополнительный)	Минимальное расстояние, в пределах которого координаты объектов считаются различимыми и на которое могут быть смещены координаты по x или y (или и то, и другое). Установите большее значение для данных с меньшей точностью координат, и меньшее значение - для данных с очень большой точностью. Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit

arcpy.analysis.Clip(in_features, clip_features, out_feature_class, {cluster_tolerance})

Имя	Объяснение	Тип данных
in_features	Объекты для вырезания.	Feature Layer; Scene Layer; File; Building Scene Layer
clip_features	Пространственные объекты, которые будут использованы для вырезания входных объектов.	Feature Layer
out_feature_class	Набор данных, который будет создан.	Feature Class; File
cluster_tolerance (Дополнительный)	Минимальное расстояние, в пределах которого координаты объектов считаются различимыми и на которое могут быть смещены координаты по x или y (или и то, и другое). Установите большее значение для данных с меньшей точностью координат, и меньшее значение - для данных с очень большой точностью. Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit

Пример кода

Пример 1 Clip (окно Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Clip("majorrds.shp", "study_quads.shp",
                    "C:/output/studyarea.shp")

Пример 2 Clip (окно Python)

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

import arcpy
arcpy.env.workspace = "C:/data"
arcpy.analysis.Clip("campus.slpk", "building_footprint.shp",
                    "C:/output/AreaOfInterest.slpk")

Пример 3 Clip (автономный скрипт)

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

# 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 Clip
arcpy.analysis.Clip(in_features, clip_features, out_feature_class)

Пример 4 Clip (автономный скрипт)

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

# Description: Clip a scene service.

# Import system modules
import arcpy

# Set workspace
arcpy.env.workspace = "C:/data"

# Set local variables
scene_service = "https://tiles.arcgis.com/tiles/z2tnIkrLQ2BRzr6P/arcgis/rest/services/2021_02_04_Frankfurt/SceneServer"
mesh_layer_name = "mesh_layer"
clip_features = "AOI.shp"
out_feature_class = "C:/output/studyarea.shp"

# Create a layer of a scene service
mesh_layer = arcpy.management.MakeSceneLayer(scene_service,
                                             mesh_layer_name)

# Run Clip
arcpy.analysis.Clip(mesh_layer, clip_features, out_feature_class)

Параметры среды

Выходное Z-значение по умолчанию, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Выходная система координат, Географические преобразования, Экстент, Наличие выходных значений M, Выходные данные содержат Z значения, Перенос свойств полей базы геоданных, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Коэффициент параллельной обработки

Особые случаи

Коэффициент параллельной обработки

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

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

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