Краткая информация
Извлекает входные объекты, которые совпадают с вырезающими объектами.
Используйте этот инструмент, чтобы вырезать часть одного класса пространственных объектов, используя один или несколько пространственных объектов другого класса как форму для печенья. Это особенно полезно для создания нового класса пространственных объектов – также называется изучаемой областью или областью интереса (AOI), который будет содержать географический поднабор пространственных объектов, скопированный из другого большего класса пространственных объектов.
Рисунок
Использование
Вырезающими объектами (Clip Features) могут быть точки, линии или полигоны, в зависимости от типа Входных объектов (Input Features).
- Когда Входные объекты (Input Features) являются полигонами, Вырезающие объекты (Clip Features) также должны быть полигонами.
- Когда Входные объекты (Input Features) являются линиями, Вырезающие объекты (Clip Features) могут быть линиями или полигонами. При вырезании линейных объектов по форме линейных объектов только совпадающие линии или их сегменты записываются в выходные данные, как показано ниже на рисунке.
- Когда Входные объекты (Input Features) являются точками, Вырезающие объекты (Clip Features) могут быть точками, линиями или полигонами. При вырезании точечных объектов по форме точечных же объектов в выходные данные записываются только совпадающие точки, как показано ниже на рисунке. При вырезании точечных объектов по форме линейных объектов в выходные данные записываются только точки, совпадающие с линейными объектами.
Выходной класс объектов (Output Feature Class) будет содержать все атрибуты Входных объектов (Input Features).
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости. Для получения более подробной информации см. Геообработка больших наборов данных.
Линейные объекты, вырезанные по форме полигональных объектов:
Точечные объекты, вырезанные по форме полигональных пространственных объектов:
Линейные объекты, вырезанные по форме линейных объектов
Точечные объекты, вырезанные по форме точечных пространственных объектов:
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции, всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена на две равные части, атрибутивное значение нового пространственного объекта будет равно половине атрибутивного значения соответствующего входного объекта. Использовать правило пропорции применяется только к числовым типам полей.
Синтаксис
Clip_analysis (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 (или и то, и другое). Установите большее значение для данных с меньшей точностью координат, и меньшее значение – для данных с очень большой точностью. | Linear unit |
Пример кода
Вырезание. Пример (Окно Python)
Пример скрипта Python для функции Вырезание с запуском из ArcGIS.
import arcpy
from arcpy import env
env.workspace = "C:/data"
arcpy.Clip_analysis("majorrds.shp", "study_quads.shp", "C:/output/studyarea.shp")
Вырезание. Пример 2 (Автономный скрипт Python)
Пример скрипта Python для функции Вырезание в автономном режиме.
# Name: Clip_Example2.py
# Description: Clip major roads that fall within the study area.
# Import system modules
import arcpy
from arcpy import env
# Set workspace
env.workspace = "C:/data"
# Set local variables
in_features = "majorrds.shp"
clip_features = "study_quads.shp"
out_feature_class = "C:/output/studyarea.shp"
xy_tolerance = ""
# Execute Clip
arcpy.Clip_analysis(in_features, clip_features, out_feature_class, xy_tolerance)
Параметры среды
- Выходное значение Z по умолчанию (Default Output Z Value)
- Разрешение M (M Resolution)
- Допуск M (M Tolerance)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходной домен M (Output M Domain)
- Выходной XY домен (Output XY Domain)
- Выходной домен Z (Output Z Domain)
- Выходная система координат (Output Coordinate System)
- Экстент (Extent)
- Выходные данные содержат значения M (Output has M values)
- Выходные данные содержат Z значения (Output has Z values)
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
- Разрешение XY (XY Resolution)
- Допуск XY (XY Tolerance)
- Разрешение Z (Z Resolution)
- Допуск Z (Z Tolerance)
Информация о лицензировании
- ArcGIS for Desktop Basic: Да
- ArcGIS for Desktop Standard: Да
- ArcGIS for Desktop Advanced: Да