Сводка
Вычисляет геометрическое пересечение между входными объектами и объектами идентичности. К входным объектам или их частям, которые совпадают с объектами идентичности, присоединяются атрибуты соответствующих объектов идентичности.
Иллюстрация
Использование
Входными объектами могут быть точки, мультиточки, линии или полигоны. Входные данные не могут быть объектами-аннотациями, объектами-размерами или сетевыми объектами.
Объекты идентичности должны быть полигонами или иметь тот же тип геометрии, что и входные объекты.
При использовании этого инструмента с точечными входными данными и полигональными объектами идентичности, точки, которые лежат непосредственно на границе полигона, будут добавлены к выходным данным дважды; по одному разу для каждого полигона, к которому относится граница. Затем вы можете запустить инструмент Пересечение с полученными выходными данными для идентификации дублирующихся точек, и вы можете решить, какую из них оставить.
Когда Входные объекты являются линиями, Объекты идентичности являются полигонами, a параметр Сохранить отношения отмечен (параметрrelationship установлен на KEEP_RELATIONSHIPS в Python), выходной класс линейных пространственных объектов будет иметь два дополнительных поля – LEFT_poly и RIGHT_poly. Эти поля содержат ID Объектов идентичности по левую и правую стороны линейного объекта.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости.Для получения более подробной информации см. Геообработка больших наборов данных.
Этот инструмент может создавать составные объекты в выходных данных, даже если все входные данные простые. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.
Синтаксис
arcpy.analysis.Identity(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)
Параметры среды
- Автоматическое подтверждение
- Полноценные имена полей
- Выходное значение Z по умолчанию
- Разрешение M
- Допуск M
- Выходное ключевое слово CONFIG
- Выходной домен M
- Выходной XY домен
- Выходной домен Z
- Выходная система координат
- Экстент
- Выходные данные имеют M-значения
- Выходные данные имеют Z-значения
- Выходная пространственная сетка 1
- Выходная пространственная сетка 2
- Выходная пространственная сетка 3
- Разрешение XY
- Допуск XY
- Разрешение Z
- Допуск Z
Информация о лицензиях
- Basic: Нет
- Standard: Нет
- Advanced: Да