Сводка
Вычисляет сводную статистику для одного или нескольких числовых полей с использованием окрестностей каждого объекта. Локальная статистика включает в себя среднее, медиану, стандартное отклонение, межквартильный диапазон, асимметрию и квантильный дисбаланс. Все статистические данные могут быть географически взвешены с использованием ядер, что позволит установить большее влияние соседям, более близким к фокальной характеристике. Могут использоваться различные типы соседства, включая диапазон расстояний, количество соседей, смежность полигонов, триангуляцию Делоне и файлы матрицы пространственных весов (.swm). Сводная статистика также рассчитывается для расстояний до соседей каждого объекта.
Более подробно о том, как работает инструмент Суммарная статистика окрестности
Иллюстрация
Использование
В дополнение к предоставленным полям анализа для каждого объекта вычисляется статистика, основанная на расстояниях до соседей. Это позволяет вам рассчитать, например, среднее значение и стандартное отклонение расстояний до каждого соседа, чтобы увидеть, находятся ли соседи близко к объекту фокуса или далеко от него. Статистика расстояния до соседей не будет в своих расчетах использовать фокальный объект, потому что это расстояние всегда равно нулю. Кроме того, эти статистические данные не будут географически взвешиваться, потому что взвешивать значения расстояний на основе тех же самых расстояний не имеет смысла.
Если выбрана опция Триангуляция Делоне для параметра Тип соседства, выходной класс пространственных объектов называется Картой Вороного.
Если входные объекты являются полигонами, все расстояния между ними определяются расстояниями между центроидами.
Локальная статистика может быть географически взвешена, только если для параметра Типы окрестностей задано Число соседей или Диапазон расстояний, потому что окрестности, основанные на смежности полигонов или триангуляции Делоне, не должны взвешиваться по расстояниям от центроида до центроида. Если для параметра Тип окрестности задано Получить пространственные веса из файла, для географического взвешивания будут автоматически использоваться веса, заданные в файле пространственных весов.
Если в качестве настройки среды Выходная система координат задана географическая система координат со значениями широты и долготы, все расстояния будут рассчитываться, как хордовые расстояния. В противном случае будут вычислены расстояния по прямой (Евклидовы расстояния).
Если вы решите игнорировать значения null с помощью параметра Игнорировать нулевые значения в вычислениях, соседи с нулевыми значениями в поле анализа будут после поиска выброшены. Это может привести к получения меньшего числа соседей, по сравнению с ожидаемым, и если указано несколько полей анализа, некоторые из них могут использовать количество соседей, отличающееся от других. Это особенно четко проявляется в случае, когда для параметра Тип окрестности задано Число соседей.
Синтаксис
arcpy.stats.NeighborhoodSummaryStatistics(in_features, output_features, {analysis_fields}, {local_summary_statistic}, {include_focal_feature}, {ignore_nulls}, {neighborhood_type}, {distance_band}, {number_of_neighbors}, {weights_matrix_file}, {local_weighting_scheme}, {kernel_bandwidth})
Parameter | Объяснение | Тип данных |
in_features | Точечные или полигональные объекты, используемые для вычисления локальной статистики. | Feature Layer |
output_features | Выходной класс объектов, содержащий локальную статистику в виде полей. Каждая статистика для каждого поля анализа будет сохранены в отдельном поле. | Feature Class |
analysis_fields [analysis_fields,...] (Дополнительный) | Одно или несколько полей, для которых будет вычисляться локальная статистика. Если не будут заданы поля анализа, будет вычислена только локальная статистика, основанная на расстояниях до соседей. | Field |
local_summary_statistic (Дополнительный) | Определяет локальную суммарную статистику, которая будет рассчитываться для каждого поля анализа.
| String |
include_focal_feature (Дополнительный) | Определяет, будет ли учитываться фокальный объект при вычислении локальной статистики для каждого объекта.
| Boolean |
ignore_nulls (Дополнительный) | Определяет, будут ли нулевые значения в полях анализа учитываться или игнорироваться в вычислениях.
| Boolean |
neighborhood_type (Дополнительный) | Определяет, как будут выбираться соседи для каждого входного объекта. Чтобы вычислить локальную статистику, для каждого входного объекта должны быть найдены соседние объекты, использующиеся для вычисления локальной статистики для каждого объекта. Для точечных объектах значение по умолчанию - Триангуляция Делоне. Для полигональных объектах значение по умолчанию - Углы соприкасающихся ребер.
| String |
distance_band (Дополнительный) | Соседями будут считаться все находящиеся в пределах этого расстояния объекты. Если значение не будет задано, оно будет получено в процессе выполнения и показано в сообщении геообработки. Если указанное расстояние приводит к получению более 1000 соседей, считаться соседями будут только ближайшие 1000 объектов. | Linear Unit |
number_of_neighbors (Дополнительный) | Число соседей для каждого локального вычисления. В это число не входит фокальный объект. Если фокальный объект будет включен в вычисления, добавится один сосед. Значение по умолчанию - 8. | Long |
weights_matrix_file (Дополнительный) | Путь и имя файла матрицы пространственных весов, который задает пространственные и, возможно, временные отношения между объектами. | File |
local_weighting_scheme (Дополнительный) | Задает схему взвешивания, применяемую к соседям при вычислении локальной статистики.
| String |
kernel_bandwidth (Дополнительный) | Ширина биквадратной или Гауссовой схем локального взвешивания. Если значение не будет задано, оно будет получено в процессе выполнения и показано в сообщении геообработки. | Linear Unit |
Пример кода
В следующем скрипте окна Python показано, как используется инструмент NeighborhoodSummaryStatistics.
import arcpy
arcpy.env.workspace = r"c:\data\project_data.gdb"
arcpy.stats.NeighborhoodSummaryStatistics("USCounties",
"USCounties_NeighborhoodSummaryStatistics", "POP2018;POP2019",
"ALL", "INCLUDE_FOCAL", "IGNORE_NULLS", "NUMBER_OF_NEIGHBORS", None,
8, None, "UNWEIGHTED")
В следующем автономном скрипте показано, как использовать инструмент NeighborhoodSummaryStatistics.
# Calculate a focal mean for the population and income of US cities.
import arcpy
# Set the current workspace
arcpy.env.workspace = r"c:\data\project_data.gdb"
# Calculate the local mean of POP2020 and MedIncome2020 fields
# using 8 nearest neighbors.
arcpy.stats.NeighborhoodSummaryStatistics("USCities", "USCities_Mean",
"POP2020;MedIncome2020", "MEAN", "EXCLUDE_FOCAL", "IGNORE_NULLS",
"NUMBER_OF_NEIGHBORS", None, 8, None, "GAUSSIAN", "50 Miles")
Environments
Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да