| Подпись | Описание | Тип данных |
Входные объекты | Входные полигональные объекты. | Feature Layer |
Выходная таблица | Выходная таблица. | Table |
Отчет по полю (полям) (Дополнительный) | Входное поле или поля атрибутов, используемые для идентификации уникальных полигонов или групп полигонов и представления их в выходных данных. | Field |
Включить перекрывающиеся области (Дополнительный) | Определяет, будут ли перекрывающиеся области анализироваться и включаться в выходные данные.
| Boolean |
Включить обе стороны отношения-соседства (Дополнительный) | Определяет, должны ли включаться в выходные данные обе стороны соседских отношений.
| Boolean |
Допуск XY (Дополнительный) | Минимальное расстояние между координатами, прежде чем они будут считаться равными. По умолчанию это допуск x, y входных объектов. Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
Выходные линейные единицы измерения (Дополнительный) | Задает единицы, которые будут использоваться для указания общей длины совпадающего ребра между соседними полигонами. По умолчанию используются единицы входного объекта.
| String |
Выходные единицы площади (Дополнительный) | Задает единицы, которые будут использоваться для указания площади перекрытия соседних полигонов. По умолчанию используются единицы входного объекта. Это параметр активен только в тех случаях, когда отмечен параметр Включить перекрывающиеся области.
| String |
Краткая информация
Создает таблицу статистики на основании примыкания полигонов (перекрытия, совпадающие ребра или узлы).
Дополнительные сведения о работе инструмента Соседние полигоны
Иллюстрация
Использование
Инструмент анализирует смежность исходных и соседних полигонов, суммируя следующую информацию:
- Область перекрытия (перекрывающиеся соседи - дополнительно)
- Длину совпадающих ребер (соприкасающиеся соседи).
- Сколько раз границы пересекаются или касаются в точке (соседи по узлу)
Инструмент анализирует и записывает примыкание только первого порядка. Другие отношения не исследуются, т.е. соседи соседей (примыкание второго порядка) не проверяются.
Параметр Отчет по полю (полям) (in_fields в Python) используется для идентификации уникальных полигонов или групп полигонов и составления отчета об их связях с соседними полигонами. Чтобы найти соседей каждого отдельного полигона во входных данных, укажите одно или несколько входных полей, имеющих уникальное значение или набор значений (в случае использования нескольких полей) для каждого полигона.
Когда заданные поля идентифицируют уникальные группы полигонов, информация о соседских отношениях суммируется и представляется по группам.
Дополнительные сведения об использовании этого параметра см. в разделе Как работает инструмент Соседние полигоны.
Вы можете использовать параметр Включить перекрывающиеся области для анализа перекрывающихся областей. Когда отмечена опция Включить перекрывающиеся области, в выходной таблице содержится поле AREA, в которое записывается площадь перекрытия для проанализированного перекрывающего соседа. Если перекрытие не обнаружено, значение в поле AREA равно 0.
Подсказка:
Расчет площади перекрытия требует большого объема системных ресурсов, и скорость работы инструмента может быть ниже, чем при определении отношений соседей, соприкасающихся ребром или узлом. Если вы знаете, что ваши данные не имеют перекрывающихся объектов или вы не заинтересованы в анализе перекрывающихся соседей, убедитесь, что параметр Включить перекрывающиеся области не отмечен (area_overlap = "NO_AREA_OVERLAP" в Python).
Внимание:
Параметр Включить перекрывающиеся области должен быть отмечен (area_overlap = "AREA_OVERLAP" в Python) для получения записей о соседях, полностью содержащихся в исходном полигоне. Если параметр Включить перекрывающиеся области не отмечен, выходная таблица не будет содержать записей о соседях, полностью содержащихся в исходном полигоне.
В выходной таблице нет записей об объектах, не являющихся соседними.
Параметр Включить обе стороны отношения-соседства используется для управления отношениями, включенными в выходные данные. Чтобы получить данные обо всех отношениях примыкания, включая взаимно обратные отношения, нужно поставить отметку Включить обе стороны отношения-соседства (both_sides = "BOTH_SIDES" в Python). Например, если OID1 – сосед OID2, в выходную таблицу добавляется запись о том, что у объекта OID1 есть сосед OID2, и запись о том, что у объекта OID2 есть сосед OID1. Если нужно указать связь только для первой стороны, снимите отметку с опции Включить обе стороны отношения-соседства. Если снять отметку с опции Включить обе стороны отношения-соседства, то в вышеприведенном примере в выходную таблицу добавляется только запись о том, что у объекта OID1 есть сосед OID2.
Параметр Выходные линейные единицы определяет единицы измерения, которые будут использоваться для длины общей границы между соседями. По умолчанию используются единицы измерения, определенные в системе координат входного объекта.
Выходные единицы площади используется только, если включен параметр Включить перекрывающиеся области (area_overlap = "AREA_OVERLAP" в Python). Когда параметр Включить перекрывающиеся области отмечен, для вычисления площади перекрытия соседей используются единицы, указанные в параметре Выходные единицы площади. По умолчанию используются единицы измерения, заданные в системе координат входного объекта.
Значением параметра Выходная таблица может быть таблица файловой базы геоданных или таблица .dbf.
Для каждого поля, указанного в параметре Отчет по полю (полям), выходная таблица будет содержать два поля с использованием следующих правил присвоения имен: src_<field> и nbr_<field>. Поля содержат значения исходного и соседнего объектов из входных данных.
Выходная таблица также будет содержат следующие поля:
- AREA– это поле содержит общую площадь перекрытия между исходным и соседним полигонами (перекрывающиеся соседи). Это поле включается в выходную таблицу, только когда активирован параметр Включить перекрывающиеся области (area_overlap = "AREA_OVERLAP" в Python).
- LENGTH– это поле содержит общую длину совпадающих ребер исходного и соседнего полигонов.
- NODE_COUNT– в это поле записывается, сколько раз исходный и соседний полигоны пересекаются или касаются друг друга в точке.
Если из входных объектов сделана выборка, будут анализироваться только выбранные объекты.
Параметры
arcpy.analysis.PolygonNeighbors(in_features, out_table, {in_fields}, {area_overlap}, {both_sides}, {cluster_tolerance}, {out_linear_units}, {out_area_units})| Имя | Описание | Тип данных |
in_features | Входные полигональные объекты. | Feature Layer |
out_table | Выходная таблица. | Table |
in_fields [field,...] (Дополнительный) | Входное поле или поля атрибутов, используемые для идентификации уникальных полигонов или групп полигонов и представления их в выходных данных. | Field |
area_overlap (Дополнительный) | Определяет, будут ли перекрытия анализироваться и включаться в выходные данные.
| Boolean |
both_sides (Дополнительный) | Определяет, должны ли включаться в выходные данные обе стороны соседских отношений.
| Boolean |
cluster_tolerance (Дополнительный) | Минимальное расстояние между координатами, прежде чем они будут считаться равными. По умолчанию это допуск x, y входных объектов. Внимание:Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов. | Linear Unit |
out_linear_units (Дополнительный) | Задает единицы, которые будут использоваться для указания общей длины совпадающего ребра между соседними полигонами. По умолчанию используются единицы входного объекта.
| String |
out_area_units (Дополнительный) | Задает единицы, которые будут использоваться для указания площади перекрытия соседних полигонов. По умолчанию используются единицы входного объекта. Этот параметр включается только тогда, когда параметр area_overlap имеет значение AREA_OVERLAP.
| String |
Пример кода
Ищет каждый соседний избирательный округ в провинции Новая Шотландия.
import arcpy
arcpy.MakeFeatureLayer_management(r"C:\Data\Canada\CanadaElecDist.shp",
"Canada_ElectoralDist")
arcpy.SelectLayerByAttribute_management("Canada_ElectoralDist", "NEW_SELECTION",
"\"PROVCODE\" = 'NS'")
count = arcpy.GetCount_management("Canada_ElectoralDist")[0]
print("Selected feature count: {}".format(count))
arcpy.PolygonNeighbors_analysis("Canada_ElectoralDist",
r"C:\Data\Output\NS_elec_neigh.dbf", "ENNAME")
print(arcpy.GetMessages())Параметры среды
Особые случаи
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да