Доступно с лицензией Spatial Analyst.
Краткая информация
Разделяет входные данные на неперекрывающиеся блоки и вычисляет статистику значений в каждом блоке. Значение присваивается всем ячейкам в каждом блоке выходных данных.
Более подробно о том, как работает инструмент Статистика по блокам
Рисунок
Использование
Если тип значений входного растра – числа с плавающей точкой, возможно вычисление только среднего, максимального и минимального значений, а также диапазона, стандартного отклонения и суммы; статистика Большинство, Меньшинство, Медиана и Разнообразие не допускается. Если входной растр целочисленный, доступно использование всех типов статистики.
Если входной растр с плавающей точкой, выходные данные будут представлены числами с плавающей точкой для всех доступных типов статистики.
Если входной растр целочисленный, выходной растр для большинства типов статистики будет также целочисленным. Выходные данные для статистики Среднее и Среднеквадратическое отклонение всегда будут с плавающей точкой.
Когда задана окрестность в форме круга, кольца или клина, в зависимости от размера окрестности, в вычислениях могут не учитываться ячейки, которые расположены на расстоянии, равном радиусу окрестности, и при этом радиусы из центра окрестности не перпендикулярны оси x- или y-axis. Однако, местоположениям этих ячеек будет присвоено результирующее значение, полученное при вычислениях статистики окрестности, поскольку они попадают в минимальный ограничивающий прямоугольник (или результирующий блок) перечисленных выше трёх круговых окрестностей.
Для типов окрестностей Нерегулярный (Irregular) и Вес (Weight) требуется наличие керн-файла. Керн-файл должен иметь расширение .txt.
Информацию о создании и использовании файлов ядра смотрите в подразделах Нерегулярный (Irregular) и Вес (Weight) в разделе Как работает инструмент Статистика по блокам.
Для статистики Медиана, если количество ячеек в блоке нечетное, значения ранжируются, и в результате в качестве медианы выдается срединное значение, которое является целочисленным. Если количество ячеек в блоке четное, значения ранжируются и два срединных значения усредняются и округляются до ближайшего целого значения.
Для статистики Большинство, ячейкам, для которых нет единственного значения большинства будет присвоено значение NoData. Это может случиться, когда два или несколько значений в пределах блока связаны, и большинство ячеек имеют одно и то же значение. Для статистики Меньшинство, ячейкам, не имеющим единственного значения меньшинства, также будет присвоено значение NoData.
Если Тип статистики – Среднее, Меньшинство, Среднеквадратическое отклонение или Сумма, тип Окрестности может быть определен как Вес.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
BlockStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})
Параметр | Объяснение | Тип данных |
in_raster | Растр, для которого будет вычислена статистика по блокам. | Raster Layer |
neighborhood (дополнительно) | Класс Neighborhood диктует форму области вокруг каждой ячейки, используемой для вычисления статистики. К доступным типам окрестностей относятся NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, и NbrWeight. Ниже приведены формы окрестности:
Окрестность по умолчанию – это квадрат NbrRectangle со стороной три ячейки. | Neighborhood |
statistics_type (дополнительно) | Тип вычисляемой статистики.
Типом статистики по умолчанию является MEAN. | String |
ignore_nodata (дополнительно) | Устанавливает, игнорируются ли в вычислениях статистики значения NoData.
| Boolean |
Возвращено значение
Имя | Объяснение | Тип данных |
out_raster | Выходной растр статистики по блокам. | Raster |
Пример кода
BlockStatistics Пример 1 (окно Python)
В этом примере вычисляется минимальное значение ячейки в каждой не-перекрывающейся окрестности кольца во входном растре Grid.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
nbr = NbrAnnulus(1, 3, "MAP")
outBlockStat = BlockStatistics("block", nbr, "MINIMUM", "")
outBlockStat.save("C:/sapyexamples/output/blockstat")
BlockStatistics, пример 2 (автономный скрипт)
В этом примере вычисляется минимальное значение ячейки в каждой не-перекрывающейся окрестности кольца во входном растре Grid.
# Name: BlockStatistics_Ex_02.py
# Description: Calculates statistics for a nonoverlapping
# neighborhood.
# 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
inRaster = "block"
nbr = NbrAnnulus(1, 3, "MAP")
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute BlockStatistics
outBlockStat = BlockStatistics(inRaster, nbr, "MINIMUM", "NODATA")
# Save the output
outBlockStat.save("C:/sapyexamples/output/blockstat")
Параметры среды
- Автоподтверждение (Auto Commit)
- Размер ячейки (Cell size)
- Сжатие (Compression)
- Текущая рабочая область (Current Workspace)
- Экстент (Extent)
- Географические преобразования (Geographic Transformations)
- Маска (Mask)
- Выходное ключевое слово CONFIG (Output CONFIG Keyword)
- Выходная система координат (Output Coordinate System)
- Статистика растра (Raster Statistics)
- Временная рабочая область (Scratch Workspace)
- Растр привязки (Snap Raster)
- Размер листа (Tile Size)