Соседние полигоны (Анализ)

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

Создает таблицу статистики на основании примыкания полигонов (перекрытия, совпадающие ребра или узлы).

Дополнительные сведения о работе инструмента Соседние полигоны

Иллюстрация

Пример работы инструмента Соседние полигоны
На схеме показан исходный полигон и его соседние полигоны.

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

  • Инструмент анализирует смежность исходных и соседних полигонов, суммируя следующую информацию:

    • Область перекрытия (перекрывающиеся соседи - дополнительно)
    • Длину совпадающих ребер (соприкасающиеся соседи).
    • Сколько раз границы пересекаются или касаются в точке (соседи по узлу)
    Итоговая информация записывается в выходную таблицу. Исходный полигон может иметь один или несколько соседних полигонов. Соседний полигон пространственно связан с исходным полигоном, по крайней мере, одним из вышеперечисленных способов.

  • Инструмент анализирует и записывает примыкание только первого порядка. Другие отношения не исследуются, т.е. соседи соседей (примыкание второго порядка) не проверяются.

  • Параметр Отчет по полю (полям) (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– в это поле записывается, сколько раз исходный и соседний полигоны пересекаются или касаются друг друга в точке.

  • Если из входных объектов сделана выборка, будут анализироваться только выбранные объекты.

Параметры

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

Входные полигональные объекты.

Feature Layer
Выходная таблица

Выходная таблица.

Table
Отчет по полю (полям)
(Дополнительный)

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

Field
Включить перекрывающиеся области
(Дополнительный)

Определяет, будут ли перекрывающиеся области анализироваться и включаться в выходные данные.

  • Не отмечено – перекрытия не будут анализироваться или включаться в выходные данные. Это значение по умолчанию
  • Отмечено – перекрытия будут анализироваться и включаться в выходные данные.

Boolean
Включить обе стороны отношения-соседства
(Дополнительный)

Определяет, должны ли включаться в выходные данные обе стороны соседских отношений.

  • Отмечено – для пары соседних полигонов будет включена информация о том, что один полигон является источником, а другой - соседом, и наоборот. Это значение по умолчанию
  • Не отмечено – для пары соседних полигонов будет включена только информация о том, что один полигон является источником, а другой - соседом. Взаимообратные отношения не будут включены.

Boolean
Допуск XY
(Дополнительный)

Минимальное расстояние между координатами, прежде чем они будут считаться равными. По умолчанию это допуск x, y входных объектов.

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit
Выходные линейные единицы измерения
(Дополнительный)

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

  • НеизвестноЕдиницы измерения будут неизвестны.
  • ДюймыЕдиницами измерения будут дюймы.
  • ФутыЕдиницами измерения будут футы.
  • ЯрдыЕдиницами измерения будут ярды.
  • МилиЕдиницами измерения будут мили.
  • Морские милиЕдиницами измерения будут морские мили.
  • МиллиметрыЕдиницами измерения будут миллиметры.
  • СантиметрыЕдиницами измерения будут сантиметры.
  • ДециметрыЕдиницами измерения будут дециметры.
  • МетрыЕдиницами измерения будут метры.
  • КилометрыЕдиницами измерения будут километры.
  • Десятичные градусыЕдиницами измерения будут десятичные градусы.
  • ТочкиЕдиницами измерения будут точки.
String
Выходные единицы площади
(Дополнительный)

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

  • НеизвестноЕдиницы измерения будут неизвестны.
  • АрыЕдиницами измерения будут ары.
  • АкрыЕдиницами измерения будут акры.
  • ГектарыЕдиницами измерения будут гектары.
  • Квадратные дюймыЕдиницами измерения будут квадратные дюймы.
  • Квадратные футыЕдиницами измерения будут квадратные футы.
  • Квадратные ярдыЕдиницами измерения будут квадратные ярды.
  • Квадратные милиЕдиницами измерения будут квадратные мили.
  • Квадратные миллиметрыЕдиницами измерения будут квадратные миллиметры.
  • Квадратные сантиметрыЕдиницами измерения будут квадратные сантиметры.
  • Квадратные дециметрыЕдиницами измерения будут квадратные дециметры.
  • Квадратные метрыЕдиницами измерения будут квадратные метры.
  • Квадратные километрыЕдиницами измерения будут квадратные километры.
String

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
(Дополнительный)

Определяет, будут ли перекрытия анализироваться и включаться в выходные данные.

  • NO_AREA_OVERLAPПерекрытия не будут анализироваться или включаться в выходные данные. Это значение по умолчанию
  • AREA_OVERLAPПерекрытия будут анализироваться и включаться в выходные данные.
Boolean
both_sides
(Дополнительный)

Определяет, должны ли включаться в выходные данные обе стороны соседских отношений.

  • BOTH_SIDESДля пары соседних полигонов будет включена информация о том, что один полигон является источником, а другой - соседом, и наоборот. Это значение по умолчанию
  • NO_BOTH_SIDESДля пары соседних полигонов будет включена только информация о том, что один полигон является источником, а другой - соседом. Взаимообратные отношения не будут включены.
Boolean
cluster_tolerance
(Дополнительный)

Минимальное расстояние между координатами, прежде чем они будут считаться равными. По умолчанию это допуск x, y входных объектов.

Внимание:

Изменение значения этого параметра может привести к сбою или неожиданным результатам. Рекомендуется не изменять этот параметр. Он был удален из поля зрения в диалоговом окне инструмента. По умолчанию используется свойство пространственной привязки допуск x,y входного класса пространственных объектов.

Linear Unit
out_linear_units
(Дополнительный)

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

  • UNKNOWNЕдиницы измерения будут неизвестны.
  • INCHESЕдиницами измерения будут дюймы.
  • FEETЕдиницами измерения будут футы.
  • YARDSЕдиницами измерения будут ярды.
  • MILESЕдиницами измерения будут мили.
  • NAUTICAL_MILESЕдиницами измерения будут морские мили.
  • MILLIMETERSЕдиницами измерения будут миллиметры.
  • CENTIMETERSЕдиницами измерения будут сантиметры.
  • DECIMETERSЕдиницами измерения будут дециметры.
  • METERSЕдиницами измерения будут метры.
  • KILOMETERSЕдиницами измерения будут километры.
  • DECIMAL_DEGREESЕдиницами измерения будут десятичные градусы.
  • POINTSЕдиницами измерения будут точки.
String
out_area_units
(Дополнительный)

Задает единицы, которые будут использоваться для указания площади перекрытия соседних полигонов. По умолчанию используются единицы входного объекта. Этот параметр включается только тогда, когда параметр area_overlap имеет значение AREA_OVERLAP.

  • UNKNOWNЕдиницы измерения будут неизвестны.
  • ARESЕдиницами измерения будут ары.
  • ACRESЕдиницами измерения будут акры.
  • HECTARESЕдиницами измерения будут гектары.
  • SQUARE_INCHESЕдиницами измерения будут квадратные дюймы.
  • SQUARE_FEETЕдиницами измерения будут квадратные футы.
  • SQUARE_YARDSЕдиницами измерения будут квадратные ярды.
  • SQUARE_MILESЕдиницами измерения будут квадратные мили.
  • SQUARE_MILLIMETERSЕдиницами измерения будут квадратные миллиметры.
  • SQUARE_CENTIMETERSЕдиницами измерения будут квадратные сантиметры.
  • SQUARE_DECIMETERSЕдиницами измерения будут квадратные дециметры.
  • SQUARE_METERSЕдиницами измерения будут квадратные метры.
  • SQUARE_KILOMETERSЕдиницами измерения будут квадратные километры.
String

Пример кода

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

Ищет каждый соседний избирательный округ в провинции Новая Шотландия.

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: Да

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