Подпись | Описание | Тип данных |
Входные объекты | Входной класс пространственных объектов или векторный слой. | Feature Layer |
Объекты идентичности | Класс пространственных объектов или слой идентичности. Тип его геометрии должен быть полигональным или как у входных объектов. | Feature Layer |
Выходной класс пространственных объектов | Создаваемый класс объектов, куда будут записаны результаты. | Feature Class |
Атрибуты для присоединения (Дополнительный) | Указывает, как атрибуты будут перенесены в выходной клас объектов.
| String |
Допуск XY (Дополнительный) | Минимальное расстояние, разделяющее координаты всех объектов (узлы и вершины), а также расстояние, на которое может переместиться координата по x или y (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Сохранить отношения (Дополнительный) | Указывает, будут ли дополнительные пространственные отношения между Входными объектами и Объектами идентичности записаны в выходные данные. Это применимо, только если тип геометрии значения параметра Входные объекты – линия, а тип геометрии значения параметра Объекты идентичности – полигон.
| Boolean |
Краткая информация
Вычисляет геометрическое пересечение между входными объектами и объектами идентичности. К входным объектам или их частям, которые совпадают с объектами идентичности, присоединяются атрибуты соответствующих объектов идентичности.
Иллюстрация
Использование
Значением параметра Входные объекты может быть точка, мультиточка, линия или полигон. Входными данными не могут быть объекты аннотации, объекты-размеры и сетевые объекты.
Значением параметра Объекты идентичности должен быть полигон или такой же тип геометрии, что и у значения параметра Входные объекты.
При использовании этого инструмента с точечными входными данными и полигональными объектами идентичности, точки, которые лежат непосредственно на границе полигона, будут добавлены к выходным данным дважды; по одному разу для каждого полигона, являющегося частью границы. Запуск инструмента Пересечение с полученными выходными данными при таком сценарии идентифицирует дублирующиеся точки, и вы можете решить, какую из них оставить.
Если геометрия значения параметра Входные объекты – линия, геометрия значения параметра Объекты идентичности – полигон, и включен параметр Сохранить отношения, выходной класс линейных пространственных объектов получит два дополнительных поля: LEFT_poly и RIGHT_poly. Эти поля содержат ID объектов значения параметра Объекты идентичности по левую и правую стороны линейного объекта.
Атрибутивные значения из входных классов пространственных объектов будут скопированы в выходной класс. Однако если входными данными является слой или слои, созданные инструментом Создать векторный слой, и отмечена опция поля Использовать правило пропорции, то тогда вычисляется доля входного значения атрибута и сохраняется как выходное атрибутивное значение. Если включено Использовать правило пропорции (Use Ratio Policy), всякий раз при разбивке пространственного объекта в операции наложения, атрибутами результирующего пространственного объекта будет пропорция значения атрибутов входных объектов. Выходное значение вычисляется на основании пропорции, в соответствии с которой была разделена геометрия входных объектов. Например, если входная геометрия была разделена поровну, каждому новому атрибутивному значению пространственного объекта присваивается половина значения атрибутивного значение входного объекта. Использовать правило пропорции применяется только к числовым типам полей.
Внимание:
Инструменты геообработки не поддерживают правила разбиения (split policies) для полей или таблиц класса пространственных объектов базы геоданных.
Для повышения производительности и масштабируемости этот инструмент использует разбиение на листы при обработке очень больших наборов данных. Для получения более подробной информации см. Обработка больших наборов данных с разбиением на листы.
Этот инструмент может создать составные объекты выходных данных, даже если все входные объекты состоят из одной части. Если вам не нужны составные объекты, используйте инструмент Составной в простые для выходного класса объектов.
Параметры
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 (или по x и y). Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
relationship (Дополнительный) | Указывает, будут ли дополнительные пространственные отношения между значениями параметров in_features и identity_features записаны в выходные данные. Это применимо, только если тип геометрии значения параметра in_features – линия, а тип геометрии значения параметра identity_features – полигон.
| Boolean |
Пример кода
В следующем скрипте окна Python показано, как используется функция Identity в режиме прямого запуска.
import arcpy
arcpy.env.workspace = "c:/data/data.gdb"
arcpy.analysis.Identity("wells", "counties", "wells_w_county_info")
Следующий автономный скрипт 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: Да