Идентичность (Identity) (Анализ)
Резюме
Вычисляет геометрическое пересечение между входными объектами и объектами идентичности. К входным объектам или их частям, которые совпадают с объектами идентичности, присоединяются атрибуты соответствующих объектов идентичности.
Рисунок
 |
Использование
-
Входными объектами могут быть точки, мультиточки, линии или полигоны. Входные данные не могут быть объектами-аннотациями, объектами-размерами или сетевыми объектами.
-
Объекты идентичности должны быть полигонами или иметь тот же тип геометрии, что и входные объекты.
-
При использовании этого инструмента с точечными входными данными и полигональными объектами идентичности, точки, которые лежат непосредственно на границе полигона, будут добавлены к выходным данным дважды; по одному разу для каждого полигона, к которому относится граница. Затем вы можете запустить инструмент Пересечение (Intersect) с полученными выходными данными для идентификации дублирующихся точек, и вы можете решить, какую из них оставить.
-
Когда Входные объекты (Input Features) являются линиями, Объекты идентичности (Identity Features) являются полигонами, a параметр Сохранить отношения (Keep relationships) отмечен флажком (либо когда параметротношение (relationship) установлен на Сохранить отношения (KEEP_RELATIONSHIPS), выходной класс линейных пространственных объектов будет иметь два дополнительных поля - LEFT_poly и RIGHT_poly. Эти поля содержат ID Объектов идентичности (Identity Features) по левую и правую стороны линейного объекта.
-
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой (Make Feature Layer), и отмечена опция поля Использовать правило пропорции (Use Ratio Policy), то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена на две равные части, атрибутивное значение нового пространственного объекта будет равно половине атрибутивного значения соответствующего входного объекта. Использовать правило пропорции (Use Ratio Policy) применяется только к числовым типам полей.
Внимание:Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.
-
Для обработки очень больших наборов данных при работе инструмента используется разбивка на листы, для повышения производительности и масштабируемости. Для получения более подробной информации см. Геообработка больших наборов данных.
-
Этот инструмент может создавать составные объекты в выходных данных, даже если все входные данные простые. Если вам не нужны составные объекты, используйте инструмент Составной в простые (Multipart to Singlepart) для выходного класса объектов.
Синтаксис
| Параметр | Объяснение | Тип данных |
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) с запуском из окна Python в ArcGIS.
import arcpy
from arcpy import env
env.workspace = "c:/data/data.gdb"
arcpy.Identity_analysis("wells", "counties", "wells_w_county_info")
Ниже приведен пример скрипта Python для применения функции Идентичность (Identity) в автономном режиме.
# 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)