Точечная статистика (Spatial Analyst)—ArcGIS Pro

Доступно с лицензией Spatial Analyst.

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

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

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

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

Выходной размер ячейки можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был явно задан как значение параметра, он извлекается из параметра среды Размер ячейки, если такой задан. Если же и в параметр среды значение размера ячейки не указано, но настроен параметр Растр привязки, то будет использоваться значение величины его ячейки. Если же ни один из параметров не задан, то размер ячейки будет вычислен как наименьшее значение длины либо ширины экстента растра, поделенное на 250, при этом экстент берется из параметра среды Выходная система координат.
Если размер ячейки указан в виде числа, то инструмент будет использовать это значение для выходного растра.
Если для определения размера ячейки указан другой растр, в параметре будет показан путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого растра будет использоваться непосредственно в анализе указанная пространственная привязка набора данных будет такой же, как и выходная система координат. Если же пространственная привязка набора данных отличается от выходной пространственной привязки, на будет перепроецирована на основе выбранного Метода проецирования размера ячейки.
Когда указанное поле является целочисленным, могут быть вычислены следующие типы статистики наложения: Среднее, Большинство, Максимум, Медиана, Минимум, Меньшинство, Диапазон, Среднеквадратическое отклонение, Сумма и Разнообразие. Когда поле содержит значения с плавающей точкой, единственные доступные типы статистики – это Среднее, Максимум, Минимум, Диапазон, Среднеквадратическое отклонение и Сумма.
Для типов статистики Большинство, Максимум, Медиана, Минимум, Меньшинство, Диапазон и Сумма тип выходных данных растра будет совпадать с типом значений входного поля. Выходной растр после статистики Среднее и Среднеквадратическое отклонение всегда будет с плавающей точкой. Для типа статистики Разнообразие выходной растр всегда будет целочисленным.
Если отсутствуют соседние точки ячейки, Разнообразие принимает значение, равное 0. При использовании других типов статистики, ячейке присваивается значение NoData.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Параметры

Подпись	Описание	Тип данных
Входные точечные объекты	Входные точечные объекты, для которых будет вычисляться статистика в окрестности вокруг каждой выходной ячейки. Входные данные могут быть представлены либо классом точечных объектов, либо классом объектов 'мультиточка'.	Feature Layer
Поле	Поле, для которого будут вычислена указанная статистика. Оно может быть любым числовым полем входных объектов. Если входные объекты содержат значения z, оно может быть представлено полем Shape.	Field
Размер выходной ячейки (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
Окрестность (Дополнительный)	Область вокруг каждой обрабатываемой ячейки, в пределах которой найденные входные точки будут использоваться при вычислении статистики. Есть несколько предопределенных типов окрестностей для выбора. Когда выбран тип окрестностей, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию является прямоугольной. Доступны следующие формы типов окрестностей: Кольцо, Внутренний радиус, Внешний радиус, Тип единиц Окрестность в форме кольца, определяемая внутренним радиусом и внешним радиусом. Кольцо по умолчанию – внутренний радиус одной ячейки и внешний радиус трех ячеек. Круг, Радиус, Тип единиц Круговая окрестность с заданным радиусом. Значение радиуса по умолчанию равно трем ячейкам. Прямоугольник, Высота, Ширина, Тип единиц Прямоугольная окрестность, определенная высотой и шириной. Прямоугольная окрестность по умолчанию – квадрат со стороной три ячейки. Клин, Радиус, Начальный угол, Конечный угол, Тип единиц Окрестность в форме клина определяется радиусом, начальным углом и конечным углом. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Можно использовать отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным трем ячейкам. Единицы расстояния для параметров могут быть заданы как единицы Ячейка или единицы Карта. По умолчанию используются единицы ячейки.	Neighborhood
Тип статистики (Дополнительный)	Задает вычисляемый тип статистики. Статистика вычисляется для значений заданного поля входных точечных данных для всех точек в окрестности каждой ячейки выходного растра. Доступные варианты типа статистики определяются числовым типом указанного поля. Если значения поля целочисленные, доступно использование всех типов статистики. Если поле имеет тип float, то доступны только статистика максимума, среднего, минимума, диапазона, стандартного отклонения и суммы. Среднее—Будет рассчитано среднее значение для значений полей в каждой окрестности. Большинство—Определяется наиболее часто возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение. Максимум—Определяется наибольшее значение поля в каждой окрестности. Медиана—Определяется среднее значение поля в каждой окрестности. В том случае, если в окрестности находится четное количество точек, результатом будет меньшее из двух средних значений. Минимум—Определяется наименьшее значение поля в каждой окрестности. Меньшинство—Определяется наиболее редко возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение. Диапазон—Вычисляется диапазон (разница между наибольшим и наименьшим) значений поля в окрестности. Стандартное отклонение—Вычисляется среднеквадратическое отклонение значений ячеек в окрестности. Сумма—Рассчитывается сумма значений полей в каждой окрестности. Разнообразие—Вычисляется число уникальных значений поля в каждой окрестности.	String

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр точечной статистики.	Raster

PointStatistics(in_point_features, field, {cell_size}, {neighborhood}, {statistics_type})

Имя	Описание	Тип данных
in_point_features	Входные точечные объекты, для которых будет вычисляться статистика в окрестности вокруг каждой выходной ячейки. Входные данные могут быть представлены либо классом точечных объектов, либо классом объектов 'мультиточка'.	Feature Layer
field	Поле, для которого будут вычислена указанная статистика. Оно может быть любым числовым полем входных объектов. Если входные объекты содержат значения z, оно может быть представлено полем Shape.	Field
cell_size (Дополнительный)	Размер ячейки выходного растра, который будет создан. Этот параметр можно задать как числовым значением, так и получить из существующего набора растровых данных. Если размер ячейки не был в явном виде задан как значение параметра, будет использоваться значение размера ячейки, указанное в параметрах среды геообработки, если же и оно не указано, будут использоваться дополнительные правила вычисления размера ячейки на основе входных данных. Более подробно см. раздел об использовании.	Analysis Cell Size
neighborhood (Дополнительный)	Область вокруг каждой обрабатываемой ячейки, в пределах которой найденные входные точки будут использоваться при вычислении статистики. Есть несколько предопределенных типов окрестностей для выбора. Когда выбран тип окрестностей, можно задать другие параметры, чтобы полностью определить форму, размер и единицы измерения. Окрестность по умолчанию является прямоугольной. Форма окрестностей вокруг каждой входной точки определяется классом Neighborhood. Доступные типы окрестностей NbrAnnulus, NbrCircle, NbrRectangle, и NbrWedge. Доступны следующие формы типов окрестностей: NbrAnnulus({innerRadius}, {outerRadius}, {units}) Окрестность в форме кольца, определяемая внутренним радиусом и внешним радиусом. Кольцо по умолчанию – внутренний радиус одной ячейки и внешний радиус трех ячеек. NbrCircle({radius}, {units} Круговая окрестность с заданным радиусом. Значение радиуса по умолчанию равно трем ячейкам. NbrRectangle({width}, {height}, {units}) Прямоугольная окрестность, определенная высотой и шириной. Прямоугольная окрестность по умолчанию – квадрат со стороной три ячейки. NbrWedge({radius}, {startAngle}, {endAngle}, {units}) Окрестность в форме клина определяется радиусом, начальным углом и конечным углом. Клин строится в направлении против часовой стрелки от начального угла до конечного угла. Углы задаются в градусах, величина равная 0 или 360 представляет восток. Можно использовать отрицательные значения углов. Клин по умолчанию имеет значение от 0 до 90 градусов, с радиусом, равным трем ячейкам. Единицы расстояния для параметров могут быть заданы как единицы CELL или единицы MAP. По умолчанию используются единицы ячейки. По умолчанию тип окрестности NbrRectangle со стороной, равной трем ячейкам.	Neighborhood
statistics_type (Дополнительный)	Задает вычисляемый тип статистики. Статистика вычисляется для значений заданного поля входных точечных данных для всех точек в окрестности каждой ячейки выходного растра. MEAN—Будет рассчитано среднее значение для значений полей в каждой окрестности. MAJORITY—Определяется наиболее часто возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение. MAXIMUM—Определяется наибольшее значение поля в каждой окрестности. MEDIAN—Определяется среднее значение поля в каждой окрестности. В том случае, если в окрестности находится четное количество точек, результатом будет меньшее из двух средних значений. MINIMUM—Определяется наименьшее значение поля в каждой окрестности. MINORITY—Определяется наиболее редко возникающее значение поля в каждой окрестности. В случае наличия связи, используется минимальное значение. RANGE—Вычисляется диапазон (разница между наибольшим и наименьшим) значений поля в окрестности. STD—Вычисляется среднеквадратическое отклонение значений ячеек в окрестности. SUM—Рассчитывается сумма значений полей в каждой окрестности. VARIETY—Вычисляется число уникальных значений поля в каждой окрестности. Доступные варианты типа статистики определяются числовым типом указанного поля. Если значения поля целочисленные, доступно использование всех типов статистики. Если поле имеет тип float, то доступны только статистика максимума, среднего, минимума, диапазона, стандартного отклонения и суммы.	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")

# Execute PointStatistics
outPointStatistics = PointStatistics(inPointFeatures, field, cellSize,
                                     neighborhood, "MEAN")

# Save the output 
outPointStatistics.save("C:/sapyexamples/output/pointstatout")

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

Автоматическое подтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Выходное ключевое слово CONFIG, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

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

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

Параметры

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

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

Пример кода

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

Особые случаи

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

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

В этом разделе