Статистика по блокам

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

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

Разделяет входные данные на неперекрывающиеся блоки и вычисляет статистику значений в каждом блоке. Значение присваивается всем ячейкам в каждом блоке выходных данных.

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

Иллюстрация

OutRas = BlockStatistics(InRas1, NbrRectangle(3,3,MAP), "MAXIMUM", "")

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

• Если тип значений входного растра – числа с плавающей точкой, возможно вычисление только среднего, максимального и минимального значений, а также диапазона, стандартного отклонения и суммы; статистика Большинство, Меньшинство, Медиана и Разнообразие не допускается. Если входной растр целочисленный, доступно использование всех типов статистики.

• Если входной растр с плавающей точкой, выходные данные будут представлены числами с плавающей точкой для всех доступных типов статистики.

  Если входной растр целочисленный, выходной растр для большинства типов статистики будет также целочисленным. Выходные данные для статистики Среднее и Среднеквадратическое отклонение всегда будут с плавающей точкой.

• Когда задана окрестность в форме круга, кольца или клина, в зависимости от размера окрестности, в вычислениях могут не учитываться ячейки, которые расположены на расстоянии, равном радиусу окрестности, и при этом радиусы из центра окрестности не перпендикулярны оси x- или y-axis. Однако, местоположениям этих ячеек будет присвоено результирующее значение, полученное при вычислениях статистики окрестности, поскольку они попадают в минимальный ограничивающий прямоугольник (или результирующий блок) перечисленных выше трёх круговых окрестностей.

• Для типов окрестностей Нерегулярный и Вес требуется наличие керн-файла. Керн-файл должен иметь расширение .txt.

  Информацию о создании и использовании файлов ядра смотрите в подразделах Нерегулярный и Вес в разделе Как работает инструмент Статистика по блокам.

• Для статистики Медиана, если количество ячеек в блоке нечетное, значения ранжируются, и в результате в качестве медианы выдается срединное значение, которое является целочисленным. Если количество ячеек в блоке четное, значения ранжируются и два срединных значения усредняются и округляются до ближайшего целого значения.

• Для статистики Большинство, ячейкам, для которых нет единственного значения большинства будет присвоено значение NoData. Это может случиться, когда два или несколько значений в пределах блока связаны, и большинство ячеек имеют одно и то же значение. Для статистики Меньшинство, ячейкам, не имеющим единственного значения меньшинства, также будет присвоено значение NoData.

• Если Тип статистики – Среднее, Меньшинство, Среднеквадратическое отклонение или Сумма, тип Окрестности может быть определен как Вес.

• См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.

Синтаксис

BlockStatistics (in_raster, {neighborhood}, {statistics_type}, {ignore_nodata})

Параметр	Объяснение	Тип данных
in_raster	Растр, для которого будет вычислена статистика по блокам.	Raster Layer
neighborhood (Дополнительный)	Класс Neighborhood диктует форму области вокруг каждой ячейки, используемой для вычисления статистики. К доступным типам окрестностей относятся NbrAnnulus, NbrCircle, NbrRectangle, NbrWedge, NbrIrregular, и NbrWeight. Ниже приведены формы окрестности: NbrAnnulus({innerRadius}, {outerRadius}, {units}) NbrCircle({radius}, {units} NbrRectangle({width}, {height}, {units}) NbrWedge({radius}, {startAngle}, {endAngle}, {units}) NbrIrregular(inKernelFile) NbrWeight(inKernelFile) Окрестность по умолчанию – это квадрат NbrRectangle со стороной три ячейки.	Neighborhood
statistics_type (Дополнительный)	Тип вычисляемой статистики. MEAN — Вычисляет среднее значений ячеек окрестности. MAJORITY — Вычисляет значение большинства (значения, которое встречается чаще других) для ячеек в окрестности. MAXIMUM — Вычисляет максимальное (наибольшее) из значений ячеек в окрестности. MEDIAN — Вычисляет значение медианы для ячеек в окрестности. MINIMUM — Вычисляет минимальное (наименьшее) из значений ячеек в окрестности. MINORITY — Вычисляет значение меньшинства (значения, встречающегося реже всего) для ячеек в окрестности. RANGE — Вычисляет диапазон (разницу между наибольшим и наименьшим значением) значений ячеек в окрестности. STD — Вычисляет стандартное (среднеквадратическое) отклонение значений ячеек в окрестности. SUM — Вычисляет сумму значений ячеек в окрестности. VARIETY — Вычисляет разнообразие (количество уникальных значений) значений ячеек в окрестности. Типом статистики по умолчанию является MEAN.	String
ignore_nodata (Дополнительный)	Устанавливает, игнорируются ли в вычислениях статистики значения NoData. DATA — Определяет, что если в окрестности блока есть значение NoData, значение NoData будет проигнорировано. При определении статистики значений будут использованы только ячейки, имеющие определенное значение. Это значение используется по умолчанию. NODATA — Определяет, что если в окрестности есть значение NoData, выходным значением для каждой ячейки в соответствующем блоке будет также значение NoData. В этом случае, когда используется ключевое слово 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)

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

• ArcGIS Desktop Basic: Требует Spatial Analyst
• ArcGIS Desktop Standard: Требует Spatial Analyst
• ArcGIS Desktop Advanced: Требует Spatial Analyst