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

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

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

Иллюстрация

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

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

  • Значением параметра Входные объекты может быть точка, мультиточка, линия или полигон. Входными данными не могут быть объекты аннотации, объекты-размеры и сетевые объекты.

  • Значением параметра Объекты идентичности должен быть полигон или такой же тип геометрии, что и у значения параметра Входные объекты.

  • При использовании этого инструмента с точечными входными данными и полигональными объектами идентичности, точки, которые лежат непосредственно на границе полигона, будут добавлены к выходным данным дважды; по одному разу для каждого полигона, являющегося частью границы. Запуск инструмента Пересечение с полученными выходными данными при таком сценарии идентифицирует дублирующиеся точки, и вы можете решить, какую из них оставить.

  • Если геометрия значения параметра Входные объекты – линия, геометрия значения параметра Объекты идентичности – полигон, и включен параметр Сохранить отношения, выходной класс линейных пространственных объектов получит два дополнительных поля: LEFT_poly и RIGHT_poly. Эти поля содержат ID объектов значения параметра Объекты идентичности по левую и правую стороны линейного объекта.

  • Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой, и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции применяется только к числовым типам полей.

    Внимание:

    Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.

  • Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.

  • Этот инструмент может создать составные объекты выходных данных, даже если все входные объекты состоят из одной части. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.

Параметры

ПодписьОписаниеТип данных
Входные объекты

Входной класс пространственных объектов или векторный слой.

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 объектов значения параметра Объекты идентичности по левую и правую стороны линейного объекта.
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 – полигон.

  • NO_RELATIONSHIPSВ выходные данные не будет записано дополнительное пространственное отношение.
  • KEEP_RELATIONSHIPSВыходные линейные объекты будут содержать два дополнительных поля: LEFT_poly и RIGHT_poly. Эти поля содержат ID объектов значения параметра identity_features по левую и правую стороны линейного объекта.
Boolean

Пример кода

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

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

import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("wells", "counties", "wells_w_county_info")
Identity, пример 2 (автономный скрипт 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)

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

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

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

Инструмент учитывает параметр среды Коэффициент параллельной обработки. Если параметр среды не задан (используется значение по умолчанию) или указан как 0, параллельная обработка будет отключена; параллельная обработка не будет применена и процессы будет выполнены последовательно. Установка параметра среды на 100 активирует параллельную обработку; параллельная обработка будет применена, и процессы будет выполняться параллельно. Если параллельная обработка включена, используется до 10 ядер.

Параллельная обработка на данном этапе поддерживается для операций наложения полигон на полигон, линия на полигон и точка на полигон.

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

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

Связанные разделы