Точечная статистика (Point Statistics) (Spatial Analyst)

Уровень лицензии:BasicStandardAdvanced

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

Вычисляет статистику для точек в окрестности каждой выходной ячейки.

Более подробно о том, как работает инструмент Точечная статистика

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

Синтаксис

PointStatistics (in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})
ПараметрОбъяснениеТип данных
in_point_features

Входные точечные объекты, для которых будет вычисляться статистика в окрестности вокруг каждой выходной ячейки.

Входные данные могут быть представлены либо классом точечных объектов, либо классом объектов 'мультиточка'.

Feature Layer
field

Поле может быть любым числовым полем класса точечных объектов.

Если входные объекты содержат значения z, поле может быть представлено полем Shape.

Field
cell_size
(дополнительно)

Размер ячейки для выходного набора растровых данных.

Значение, устанавливаемое в параметрах среды. Если этот параметр не задан в параметрах среды, используется меньший размер из значений ширины или высоты экстента входного набора классов объектов в выходной пространственной привязке, деленный на 250.

Analysis Cell Size
neighborhood
(дополнительно)

Класс Окрестности диктует форму области вокруг каждой входной точки, используемой для вычисления статистики.

Различные типы окрестности: NbrAnnulus, NbrCircle, NbrRectangle, и NbrWedge.

Ниже приведены формы окрестности:

  • NbrAnnulus({innerRadius}, {outerRadius}, {units})
  • NbrCircle({radius}, {units}
  • NbrRectangle({width}, {height}, {units})
  • NbrWedge({radius}, {startAngle}, {endAngle}, {units})

Окрестность по умолчанию – это квадрат NbrRectangle со стороной три ячейки.

Neighborhood
statistics_type
(дополнительно)

Тип вычисляемой статистики.

Статистика вычисляется для значений заданного поля входных точечных данных для всех точек в окрестности каждой ячейки выходного растра.

  • MEAN Вычисляет среднее значение поля в каждой окрестности.
  • MAJORITY Определяет наиболее часто возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение.
  • MAXIMUM Определяет наибольшее значение поля в каждой окрестности.
  • MEDIAN Определяет среднее значение поля в каждой окрестности. В том случае, если в окрестности находится четное количество точек, результатом будет меньшее из двух средних значений.
  • MINIMUM Определяет наименьшее значение поля в каждой окрестности.
  • MINORITY Определяет наиболее редко возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение.
  • RANGE Вычисляет диапазон (разница между наибольшим и наименьшим) значений поля в окрестности.
  • Стандартное отклонение (STD) Вычисляет стандартное отклонение значений ячеек в окрестности.
  • SUM Вычисляет общее значение поля в каждой окрестности.
  • VARIETY Вычисляет число уникальных значений поля в каждой окрестности.
String

Возвращено значение

ИмяОбъяснениеТип данных
out_raster

Выходной растр точечной статистики.

Raster

Пример кода

Точечная статистика. Пример 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")
Точечная статистика. Пример 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")

Параметры среды

Связанные темы

Информация о лицензировании

ArcGIS for Desktop Basic: Требует Дополнительный модуль Spatial Analyst
ArcGIS for Desktop Standard: Требует Дополнительный модуль Spatial Analyst
ArcGIS for Desktop Advanced: Требует Дополнительный модуль Spatial Analyst
6/5/2014