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

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

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

Иллюстрация

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

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

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

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

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

  • Когда Входные объекты являются линиями, Объекты идентичности являются полигонами, a параметр Сохранить отношения отмечен (параметрrelationship установлен на KEEP_RELATIONSHIPS в Python), выходной класс линейных пространственных объектов будет иметь два дополнительных поля – LEFT_poly и RIGHT_poly. Эти поля содержат ID Объектов идентичности по левую и правую стороны линейного объекта.

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

    Внимание:

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

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

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

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

Параметры

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

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

Feature Layer
Объекты идентичности

Класс пространственных объектов или слой идентичности. Должны быть полигонами или иметь тот же тип геометрии, что входные объекты.

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

Создаваемый класс пространственных объектов, в который будет записан результат операции.

Feature Class
Атрибуты для присоединения
(Дополнительный)

Определяет, какие атрибуты будут перемещены в выходной класс объектов.

  • Все атрибутыВсе атрибуты (включая FIDs) входных объектов и объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значения объекта идентичности не будут перенесены в выходные данные (вместо значений будут использованы пустые строки или 0), а FID объекта идентичности будет равен -1. Это значение по умолчанию.
  • Все атрибуты, кроме ID объектовВсе атрибуты, за исключением FID, из входных объектов и объектов идентичности будут перенесены в выходные объекты. Если пересечение не найдено, значения объекта идентичности не будут перенесены в выходные данные (вместо значений будут использованы пустые строки или 0).
  • Только ID объектовВсе атрибуты из входных объектов и только FID из объектов идентичности будут перенесены в выходные объекты. Если пересечение отсутствует, атрибутивное значение FID объектов идентичности в выходных данных будет -1.
String
Допуск XY
(Дополнительный)

Минимальное расстояние, в пределах которого координаты узлов и вершин объектов считаются различимыми, и на которое могут быть смещены координаты по оси 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 входного класса пространственных объектов.

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)

Пример скрипта для использования функции Identity с запуском из окна 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 для применения функции 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)

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

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

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