| Подпись | Описание | Тип данных |
Входные объекты или набор данных | Пространственные объекты, к которым будет применена операция вырезания. | Feature Layer; Scene Layer; File |
Вырезающие объекты | Объекты, используемые для вырезания входных объектов. | Feature Layer |
Выходные объекты или набор данных | Создаваемый набор данных. | Feature Class; File |
Допуск XY (Дополнительный) | Минимальное расстояние, в пределах которого координаты объектов считаются различимыми и на которое могут быть смещены координаты по x или y (или и то, и другое). Установите большее значение для данных с меньшей точностью координат, и меньшее значение - для данных с очень большой точностью. Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Краткая информация
Извлекает входные объекты, которые перекрываются вырезающими объектами.
Используйте этот инструмент, чтобы вырезать часть одного набора данных по форме одного или нескольких объектов из другого набора данных, аналогично вырезанию печенья формочкой. Обычно используется для создания нового набора данных, также называемого изучаемой областью или областью интереса (AOI), который будет содержать географический поднабор пространственных объектов, скопированный из другого большего набора данных.
Для операций вырезания доступен другой инструмент. См. инструмент Попарное вырезание для дополнительной информации.
Иллюстрация
Использование
Для параметра Вырезающие объекты значениями могут быть точки, линии или полигоны, в зависимости от типа параметра Входные объекты или набор данных.
- Когда значения для Входные объекты или набор данных являются полигонами, Вырезающие объекты также должны быть полигонами.
- Когда значения для Входные объекты или набор данных являются линиями, Вырезающие объекты могут быть линиями или полигонами. При вырезании линейных объектов по форме линейных объектов только совпадающие линии или их сегменты записываются в выходные данные, как показано ниже на рисунке.
- Когда значения для Входные объекты или набор данных являются точками, Вырезающие объекты могут быть точками, линиями или полигонами. При вырезании точечных объектов по форме точечных же объектов в выходные данные записываются только совпадающие точки, как показано ниже на рисунке. При вырезании точечных объектов по форме линейных объектов в выходные данные записываются только точки, совпадающие с линейными объектами.
- Если значения параметра Входные объекты или набор данных являются интегрированной моделью mesh, 3D объектом или облаком точек, слоем сцены или пакетом слоя сцены интегрированной модели mesh, значения для Вырезающие объекты также должны быть полигонами.
Параметр Выходные объекты или набор данных будет содержать все атрибуты параметра Входные объекты или набор данных, если выходные данные являются классом объектов.
Пакеты слоя сцены Интегрированная модель mesh и 3D объект должны использовать I3S версии 1.6 или выше, чтобы его можно было использовать в качестве входных данных. Используйте инструмент Обновить слой сцены для обновления пакетов слоев сцены версии 1.5 или более ранних версий. Выходной пакет слоя сцены будет в последней версии I3S.
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости.Для получения более подробной информации см. Геообработка больших наборов данных.
Линейные объекты вырезаны полигональными объектами:
Точечные объекты вырезаны полигональными объектами:
Линейные объекты вырезаны линейными объектами:
Точечные объекты вырезаны точечными объектами:
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.
Внимание:
Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.
Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (используется значение по умолчанию) или указан как 0, параллельная обработка будет отключена. Установка параметра среды на 100 активирует параллельную обработку. Если параллельная обработка включена, используется до 10 ядер.
Параметры
arcpy.analysis.Clip(in_features, clip_features, out_feature_class, {cluster_tolerance})| Имя | Описание | Тип данных |
in_features | Пространственные объекты, к которым будет применена операция вырезания. | Feature Layer; Scene Layer; File |
clip_features | Объекты, используемые для вырезания входных объектов. | Feature Layer |
out_feature_class | Создаваемый набор данных. | Feature Class; File |
cluster_tolerance (Дополнительный) | Минимальное расстояние, в пределах которого координаты объектов считаются различимыми и на которое могут быть смещены координаты по x или y (или и то, и другое). Установите большее значение для данных с меньшей точностью координат, и меньшее значение - для данных с очень большой точностью. Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Пример кода
В следующем скрипте окна Python показано, как используется функция Clip в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Clip_analysis("majorrds.shp", "study_quads.shp",
"C:/output/studyarea.shp")В следующем скрипте окна Python показано, как используется функция Clip с пакетом слоя сцены.
import arcpy
arcpy.env.workspace = "C:/data"
arcpy.Clip_analysis("campus.slpk", "building_footprint.shp",
"C:/output/AreaOfInterest.slpk")В следующем скрипте Python показано, как использовать функцию Clip в автономном скрипте.
# Name: Clip_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 Clip
arcpy.Clip_analysis(in_features, clip_features, out_feature_class)Параметры среды
Выходное значение Z по умолчанию, Разрешение M, Допуск M, Выходное ключевое слово CONFIG, Выходной домен M, Выходной XY домен, Выходной домен Z, Выходная система координат, Экстент, Выходные данные имеют M-значения, Выходные данные имеют Z-значения, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Коэффициент параллельной обработки
Особые случаи
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да