Сводка
Возвращает минимальные, максимальные и средние расстояния до указанного N-го ближайшего соседа (N – входной параметр) для набора объектов. По мере работы инструмента производится запись сообщений.
Иллюстрация
Использование
Для данного набора объектов инструмент возвращает минимальные, максимальные и средние расстояния до указанного числа соседних объектов (N). Пример: если указать значение 8 для параметра Соседи, инструмент создаст список расстояний от каждого объекта до его восьми ближайших соседей, затем на основе этого списка производится расчет минимального, максимального и среднего расстояний.
- Максимальное значение – это расстояние, в пределах которого каждый из объектов имеет хотя бы N соседних объектов.
- Минимальное значение – это расстояние, в пределах которого хотя бы один из объектов имеет N соседних объектов.
- Среднее значение – это среднее расстояние, в пределах которого объекты имеют N соседних объектов.
Результаты работы этого инструмента выводятся в виде сообщения в Окно результатов (Results window). Щелкните правой кнопкой Сообщения (Messages) и выберите Просмотреть (View), при этом результаты можно будет увидеть в Диалоговом окне сообщения (Message dialog box).
Некоторые инструменты, такие как Анализ горячих точек (Hot Spot Analysis (Getis-Ord Gi*)) или Пространственная автокорреляция (Spatial_Autocorrelation (Global Moran's I)), позволяют указать значение Диапазон расстояний или порогового расстояния (Distance Band or Threshold Distance) соседних объектов. Указав в параметре Диапазон расстояний или пороговое значение (Distance Band or Threshold Distance) значение Максимального расстояния, полученное этим инструментом, можно удостовериться в том, что каждый объект во входном классе имеет, по меньшей мере, N соседних объектов.
Данный инструмент обеспечивает один из вариантов получения значений для параметра Диапазон расстояний или пороговое расстояние (Distance Band or Threshold Distance), что необходимо при использовании некоторых инструментов набора Пространственной статистики. В том числе Анализ горячих точек (Hot Spot Analysis (Getis-Ord Gi*)) или Анализ кластеров и ниспадающих значений (Cluster and Outlier Analysis (Local Moran's I)). В ссылке Выбор фиксированного расстояния приведены дополнительные варианты.
Расстояния, возвращаемые в результате работы инструмента, измеряются в единицах среды геообработки Выходная система координат.
Когда Входной класс объектов не имеет проекции (т.е. когда координаты заданы в градусах, минутах и секундах), или когда в качестве выходной системы координат используется Географическая система координат, расстояния будут рассчитываться с помощью хордовых измерений. Измерения хордовых расстояний применяются постольку, поскольку они могут быть быстро вычислены и дают очень хорошие оценки истинных геодезических расстояний, по крайней мере, для точек, расстояние между которыми в пределах порядка тридцати градусов. Хордовые расстояния основаны на эллипсоиде вращения. Если взять две любые точки на поверхности Земли, то хордовым расстоянием между ними будет длина прямой линии, проходящей через трехмерное тело Земли и соединяющей эти две точки. Хордовые расстояния выражаются в метрах.
-
Для линейных или полигональных объектов, при расчете расстояний используются центроиды. Для мультиточек, полилиний или полигонов, состоящих их нескольких частей, центроид вычисляется с использованием средневзвешенного центра всех частей объекта. При определении весов точечные объекты имеют равный вес (1). Для линейных объектов это длина сегмента. Для полигональных – площадь.
Синтаксис
arcpy.stats.CalculateDistanceBand(Input_Features, Neighbors, Distance_Method)
Параметр | Объяснение | Тип данных |
Input_Features | Класс или слой пространственных объектов, применяемый для расчета статистики по расстояниям. | Feature Layer |
Neighbors | Число соседних объектов (N), принимаемых во внимание для каждого объекта. Это число должно быть целым, оно должно находиться в пределах от единицы до полного количества объектов в классе. Составляется список расстояний от каждого объекта до его N-х соседних объектов, затем в окно результатов выводится максимальное, минимальное и среднее расстояние. | Long |
Distance_Method | Определяет, как рассчитываются расстояния от одного объекта до соседнего объекта.
| String |
Производные выходные данные
Имя | Объяснение | Тип данных |
Minimum_Distance | Минимальное расстояние N-соседства. | Double |
Average_Distance | Среднее расстояние N-соседства. | Double |
Maximum_Distance | Максимальное расстояние N-соседства. | Double |
Пример кода
CalculateDistanceBand, пример 1 (окно Python)
Следующий скрипт окна Python демонстрирует, как использовать инструмент CalculateDistanceBand.
import arcpy
arcpy.env.workspace = "c:/data"
mindist, avgdist, maxdist = arcpy.CalculateDistanceBand_stats("Blocks", 10, "EUCLIDEAN_DISTANCE")
CalculateDistanceBand, пример 2 (автономный скрипт)
Следующий автономный Python скрипт демонстрирует, как использовать инструмент CalculateDistanceBand.
# import module
import arcpy
# Set geoprocessing environment Workspace
arcpy.env.workspace = "c:/data"
# Set variables
infc = "Blocks"
field = "POP2000"
outfc = "PopHotSpots"
neighbors = 10
# Run the CalculateDistanceBand tool to get a distance for use with the Hot Spot tool from the tool result object
mindist, avgdist, maxdist = arcpy.CalculateDistanceBand_stats(infc, neighbors, "EUCLIDEAN_DISTANCE")
# Run the Hot Spot Analysis tool, using the maxdist output from the Calculate Distance Band tool as an input
arcpy.HotSpots_analysis(infc, field, outfc, "Fixed Distance Band", "EUCLIDEAN_DISTANCE", "None", maxdist)
Параметры среды
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да
Связанные разделы
- Обзор группы инструментов Утилиты
- Анализ горячих точек (Getis-Ord Gi*)
- Анализ кластеров и выбросов (Anselin Локальный индекс Морана I)
- Пространственная автокорреляция (Глобальный индекс Морана I)
- Кластеризация с высокими/низкими значениями (Глобальный индекс Getis-Ord G)
- Использование окна Результаты (Results)