Идентичность (Инструменты Анализа)

Краткая информация

Вычисляет геометрическое пересечение между входными объектами и объектами идентичности. К входным объектам или их частям, которые совпадают с объектами идентичности, присоединяются атрибуты соответствующих объектов идентичности.

Иллюстрация

Иллюстрация инструмента Идентичность

Использование

Значением параметра Входные объекты может быть точка, мультиточка, линия или полигон. Входными данными не могут быть объекты аннотации, объекты-размеры и сетевые объекты.
Значением параметра Объекты идентичности должен быть полигон или такой же тип геометрии, что и у значения параметра Входные объекты.
При использовании этого инструмента с точечными входными данными и полигональными Объектами идентичности, точки, которые лежат непосредственно на границе полигона, будут добавлены к выходным данным дважды; по одному разу для каждого полигона, являющегося частью границы. Запуск инструмента Пересечение с полученными выходными данными при таком сценарии идентифицирует дублирующиеся точки, и вы можете решить, какую из них оставить.
Если геометрия значения параметра Входные объекты – линия, геометрия значения параметра Объекты идентичности – полигон, и включен параметр Сохранить отношения, выходной класс линейных пространственных объектов получит два дополнительных поля: LEFT_poly и RIGHT_poly. Эти поля содержат ID объектов значения параметра Объекты идентичности по левую и правую стороны линейного объекта.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой, и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции, всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Опция Использовать правило пропорции применяется только к числовым типам полей.

Внимание:

Инструменты геообработки игнорируют правила разбиения, заданные для полей таблицы или классов пространственных объектов базы геоданных.
Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.
Этот инструмент может создать составные объекты выходных данных, даже если все входные объекты состоят из одной части. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.

Подпись	Объяснение	Тип данных
Входные объекты	Входной класс пространственных объектов или векторный слой.	Feature Layer
Объекты идентичности	Класс пространственных объектов или слой идентичности. Тип его геометрии должен быть полигональным или как у входных объектов.	Feature Layer
Выходной класс пространственных объектов	Создаваемый класс объектов, куда будут записаны результаты.	Feature Class
Атрибуты для присоединения (Дополнительный)	Указывает, как атрибуты будут перенесены в выходной клас объектов. Все атрибуты–Все атрибуты (включая FIDs) входных объектов и объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значения объекта идентичности не будут перенесены в выходные данные (вместо значений будут использованы пустые строки или 0), а FID объекта идентичности будет равен -1. Используется по умолчанию. Все атрибуты, кроме ID объектов–Все атрибуты, за исключением FID, из входных объектов и объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значения объекта идентичности не будут перенесены в выходные данные (вместо значений будут использованы пустые строки или 0). Только ID объектов–Все атрибуты из входных объектов и только FID из объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значение атрибута FID объекта идентичности в выходных данных будет равно -1.	String
Допуск XY (Дополнительный)	Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit
Сохранить отношения (Дополнительный)	Указывает, будут ли дополнительные пространственные отношения между Входными объектами и Объектами идентичности записаны в выходные данные. Это применимо, только если тип геометрии значения параметра Входные объекты – линия, а тип геометрии значения параметра Объекты идентичности – полигон. Отмечено–Выходные линейные объекты будут содержать два дополнительных поля: `LEFT_poly` и `RIGHT_poly`. Эти поля содержат ID объектов значения параметра `identity_features` по левую и правую стороны линейного объекта. Не отмечено–В выходные данные не будет записано дополнительное пространственное отношение.	Boolean

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 (Дополнительный)	Указывает, как атрибуты будут перенесены в выходной клас объектов. `ALL`–Все атрибуты (включая FIDs) входных объектов и объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значения объекта идентичности не будут перенесены в выходные данные (вместо значений будут использованы пустые строки или 0), а FID объекта идентичности будет равен -1. Используется по умолчанию. `NO_FID`–Все атрибуты, за исключением FID, из входных объектов и объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значения объекта идентичности не будут перенесены в выходные данные (вместо значений будут использованы пустые строки или 0). `ONLY_FID`–Все атрибуты из входных объектов и только FID из объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значение атрибута FID объекта идентичности в выходных данных будет равно -1.	String
cluster_tolerance (Дополнительный)	Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание: Изменение значения этого параметра может привести к сбою или получению неожиданных результатов. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется параметр допуск x,y пространственной привязки входного класса объектов.	Linear Unit
relationship (Дополнительный)	Указывает, будут ли дополнительные пространственные отношения между значениями параметров `in_features` и `identity_features` записаны в выходные данные. Это применимо, только если тип геометрии значения параметра `in_features` – линия, а тип геометрии значения параметра `identity_features` – полигон. `KEEP_RELATIONSHIPS`–Выходные линейные объекты будут содержать два дополнительных поля: `LEFT_poly` и `RIGHT_poly`. Эти поля содержат ID объектов значения параметра `identity_features` по левую и правую стороны линейного объекта. `NO_RELATIONSHIPS`–В выходные данные не будет записано дополнительное пространственное отношение.	Boolean

Пример кода

Пример 1 Identity (окно Python)

В следующем скрипте окна Python показано, как используется функция Identity в режиме прямого запуска.

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("wells", "counties", "wells_w_county_info")

Пример 2 Identity (автономный скрипт Python)

Следующий автономный скрипт Python показывает простой пример применения функции Identity в скриптах.

# IdentityWells.py
# Description: Simple example showing use of Identity tool

# Import system modules
import arcpy

# Set the workspace
arcpy.env.workspace = "C:/data/data.gdb"

# Set local parameters
inFeatures = "wells"
idFeatures = "counties"
outFeatures = "wells_w_county_info"

# Process: Use the Identity function
arcpy.analysis.Identity(inFeatures, idFeatures, outFeatures)

Параметры среды

Автоподтверждение, Поддержка полноценных имен полей, Выходное Z-значение по умолчанию, Разрешение M, Допуск M, Выходное ключевое слово конфигурации, Выходной M домен, Выходной XY домен, Выходной Z домен, Выходная система координат, Географические преобразования, Экстент, Наличие выходных значений M, Выходные данные содержат Z значения, Разрешение XY, Допуск XY, Разрешение Z, Допуск Z, Коэффициент параллельной обработки, Перенос свойств полей базы геоданных

Особые случаи

Коэффициент параллельной обработки

This tool honors the Parallel Processing Factor environment. If the environment is not set (the default) or is set to 0, parallel processing will be disabled; parallel processing will not be used and processing will be done sequentially. Setting the environment to 100 will enable parallel processing; parallel processing will be used and processing will be done in parallel. Up to 10 cores will be used when parallel processing is enabled.

Parallel processing is currently supported for polygon-on-polygon, line-on-polygon, and point-on-polygon overlay operations.

Информация о лицензировании

Basic: Нет
Standard: Нет
Advanced: Да