Краткая информация
Вычисляет геометрическое пересечение между входными объектами и объектами идентичности. К входным объектам или их частям, которые совпадают с объектами идентичности, присоединяются атрибуты соответствующих объектов идентичности.
Рисунок
Использование
Входными объектами могут быть точки, мультиточки, линии или полигоны. Входные данные не могут быть объектами-аннотациями, объектами-размерами или сетевыми объектами.
Объекты идентичности должны быть полигонами или иметь тот же тип геометрии, что и входные объекты.
При использовании этого инструмента с точечными входными данными и полигональными объектами идентичности, точки, которые лежат непосредственно на границе полигона, будут добавлены к выходным данным дважды; по одному разу для каждого полигона, к которому относится граница. Затем вы можете запустить инструмент Пересечение с полученными выходными данными для идентификации дублирующихся точек, и вы можете решить, какую из них оставить.
Когда Входные объекты являются линиями, Объекты идентичности являются полигонами, a параметр Сохранить отношения отмечен (параметрrelationship установлен на KEEP_RELATIONSHIPS в Python), выходной класс линейных пространственных объектов будет иметь два дополнительных поля – LEFT_poly и RIGHT_poly. Эти поля содержат ID Объектов идентичности по левую и правую стороны линейного объекта.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции, всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена на две равные части, атрибутивное значение нового пространственного объекта будет равно половине атрибутивного значения соответствующего входного объекта. Использовать правило пропорции применяется только к числовым типам полей.
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости. Для получения более подробной информации см. Геообработка больших наборов данных.
Этот инструмент может создавать составные объекты в выходных данных, даже если все входные данные простые. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.
Синтаксис
Identity_analysis (in_features, identity_features, out_feature_class, {join_attributes}, {cluster_tolerance}, {relationship})| Параметр | Объяснение | Тип данных |
in_features | Входной класс пространственных объектов или слой. | Feature Layer |
identity_features | Класс пространственных объектов или слой идентичности. Должны быть полигонами или иметь тот же тип геометрии, что входные объекты. | Feature Layer |
out_feature_class | Создаваемый класс пространственных объектов, в который будет записан результат операции. | Feature Class |
join_attributes (дополнительно) | Определяет, какие атрибуты будут перемещены в выходной класс объектов.
| String |
cluster_tolerance (дополнительно) | Минимальное расстояние, в пределах которого координаты узлов и вершин объектов считаются различимыми, и на которое могут быть смещены координаты по оси X или Y (или по обеим вместе). | Linear unit |
relationship (дополнительно) | Определяет, будут ли дополнительные пространственные отношения между in_features и identity_features записываться в выходной класс пространственных объектов. Это применяется, только если in_features являются линейными, а identity_features – полигональными.
| Boolean |
Пример кода
Identity, пример 1 (окно Python)
Пример скрипта для использования функции Идентичность с запуском из окна Python в ArcGIS.
import arcpy
from arcpy import env
env.workspace = "c:/data/data.gdb"
arcpy.Identity_analysis("wells", "counties", "wells_w_county_info")
Identity, пример 2 (автономный скрипт Python)
Ниже приведен пример скрипта Python для применения функции Идентичность в автономном режиме.
# IdentityWells.py
# Description: Simple example showing use of Identity tool
# Import system modules
import arcpy
from arcpy import env
# Set the workspace
env.workspace = "C:/data/data.gdb"
# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"
# Process: Use the Identity function
arcpy.Identity_analysis (inFeatures, idFeatures, outFeatures)
Параметры среды
- Автоподтверждение (Auto Commit)
- Стандартизированные имена полей (Qualified Field Names)
- Выходное значение 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: Да