Точечная статистика (Инструменты Spatial Analyst)

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

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

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

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

Существует несколько форм окрестности и типов статистики для выбора. Выбор доступной статистики зависит от типа указанного поля.
Типы статистики, являющиеся доступными для выбора для целочисленных полей: большинство, максимум, среднее, медиана, минимум, меньшинство, диапазон, стандартное (среднеквадратическое) отклонение, сумма и разнообразие. Допустимая статистика для полей float (с плавающей точкой): максимум, среднее, минимум, диапазон, среднеквадратическое отклонение и сумма. Большинство, меньшинство и разнообразие не доступны.
Если тип поля целочисленный, выходной растр будет целочисленным для следующей статистики: большинство, максимум, медиана, минимум, меньшинство, диапазон, сумма и разнообразие. Выходной растр будет с плавающей точкой для статистики среднее и среднеквадратическое отклонение.

Если тип поля с плавающей точкой, выходной растр будет с плавающей точки для всех доступных типов статистики.
Если в окрестности ячейки растра нет точек, статистика Разнообразие присваивает ей значение, равное 0. При использовании других типов статистики, ячейке присваивается значение NoData.
Параметр Размер выходной ячейки может быть задан числовым значениям или получен из имеющегося набора растровых данных. Если размер ячейки не был явно указан в качестве значения параметра, он извлекается из среды Размер ячейки, если он был указан. Если параметр размера ячейки или параметр среды размера ячейки не были заданы, но задан параметр среды Растр привязки, используется размер ячейки растра привязки. Если нечего не задано, размер ячейки рассчитывается как меньшее из значений ширины или высоты экстента, деленных на 250, в которых экстент находится в выходной системе координат, указанной в параметрах среды.
Если размер ячейки задан с использованием числового значения, инструмент будет использовать его непосредственно для выходного растра.

Если размер ячейки задан с использованием набора растровых данных, параметр покажет путь к набору растровых данных вместо значения размера ячейки. Размер ячейки этого набора растровых данных будет использоваться непосредственно в анализе при условии, что пространственная привязка набора данных совпадает с выходной пространственной привязкой. Если пространственная привязка набора данных отличается от выходной пространственной привязки, она будет спроецирована на основе значения Метод проецирования размера ячейки.
См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

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

# Run 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

Точечная статистика (Инструменты Spatial Analyst)

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

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

Параметры

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

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

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

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