Доступно с лицензией Spatial Analyst.
Краткая информация
Вычисляет статистику для точек в окрестности каждой выходной ячейки.
Более подробно о том, как работает инструмент Точечная статистика
Использование
Выходной размер ячейки можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки невозможно указать непосредственно как значение параметра, он будет получен из параметра среды Размер ячейки, если он был там задан. Если же и в параметр среды значение размера ячейки не указано, но настроен параметр Растр привязки, то будет использоваться значение величины его ячейки. Если же ни один из параметров не задан, то размер ячейки будет вычислен как наименьшее значение длины либо ширины экстента растра, поделенное на 250, при этом экстент берется из параметра среды Выходная система координат.
Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.
Если для определения размера ячейки указан другой растр, в параметре будет показан путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого растра будет использоваться непосредственно в анализе указанная пространственная привязка набора данных будет такой же, как и выходная система координат. Если же пространственная привязка набора данных отличается от выходной пространственной привязки, на будет перепроецирована на основе выбранного Метода проецирования размера ячейки.
Когда указанное поле является целочисленным, могут быть вычислены следующие типы статистики наложения: Среднее, Большинство, Максимум, Медиана, Минимум, Меньшинство, Диапазон, Среднеквадратическое отклонение, Сумма и Разнообразие. Когда поле содержит значения с плавающей точкой, единственные доступные типы статистики – это Среднее, Максимум, Минимум, Диапазон, Среднеквадратическое отклонение и Сумма.
Для типов статистики Большинство, Максимум, Медиана, Минимум, Меньшинство, Диапазон и Сумма тип выходных данных растра будет совпадать с типом значений входного поля. Выходной растр после статистики Среднее и Среднеквадратическое отклонение всегда будет с плавающей точкой. Для типа статистики Разнообразие выходной растр всегда будет целочисленным.
Если отсутствуют соседние точки ячейки, Разнообразие принимает значение, равное 0. При использовании других типов статистики, ячейке присваивается значение NoData.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})| Параметр | Объяснение | Тип данных |
in_point_features | Входные точечные объекты, для которых будет вычисляться статистика в окрестности вокруг каждой выходной ячейки. Входные данные могут быть представлены либо классом точечных объектов, либо классом объектов 'мультиточка'. | Feature Layer |
field | Поле, для которого будет вычислена указанная статистика. Оно может быть любым числовым полем входных объектов. Это может быть поле Shape, если входные объекты содержат значения z. | Field |
cell_size (Дополнительный) | Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. использование. | Analysis Cell Size |
neighborhood (Дополнительный) | Класс Neighborhood диктует форму области вокруг каждой входной точки, используемой для вычисления статистики. Типы окрестности включают: NbrAnnulus, NbrCircle, NbrRectangle, и NbrWedge. Ниже приведены формы окрестности:
Окрестность по умолчанию – это квадрат NbrRectangle со стороной 3 ячейки. | Neighborhood |
statistics_type (Дополнительный) | Указывает тип вычисляемой статистики. Статистика вычисляется для значений заданного поля входных точечных данных для всех точек в окрестности каждой ячейки выходного растра.
Доступные варианты типа статистики определяются числовым типом указанного поля. | String |
Возвращаемое значение
| Имя | Объяснение | Тип данных |
| out_raster | Выходной растр точечной статистики. | Raster |
Пример кода
PointStatistics Пример 1 (окно Python)
В этом примере определяется статистика (сумма) точечных объектов входного шейп-файла, которые попадают круглую окрестность вокруг каждой ячейки выходного растра.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPointStats = PointStatistics("ca_ozone_pts.shp", "OZONE", 500,
NbrCircle(10000, "MAP"), "SUM")
outPointStats.save("C:/sapyexamples/output/pointstatsout")
PointStatistics, пример 2 (автономный скрипт)
В этом примере определяется статистика (среднее) точечных объектов входного шейп-файла, которые попадают круглую окрестность вокруг каждой ячейки выходного растра.
# Name: PointStatistics_Ex_02.py
# Description: Calculates a statistic on points over a specified
# neighborhood outputting a raster.
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inPointFeatures = "ca_ozone_pts.shp"
field = "OZONE"
cellSize = 500
neighborhood = NbrCircle(6000, "MAP")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
neighborhood, "MEAN")
# Save the output
outPointStatistics.save("C:/sapyexamples/output/pointstatout")
Параметры среды
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst