Статистика по ячейкам (Spatial Analyst)

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

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

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

Вычисляет статистику по ячейкам на основании значений из нескольких растров.

Доступная статистика: Большинство, Максимум, Среднее, Медиана, Минимум, Меньшинство, Диапазон, Среднеквадратическое отклонение, Сумма и Разнообразие.

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

Иллюстрация

OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

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

• Для этого инструмента не имеет значения порядок входных растров.

• Для типов статистики Максимум (Maximum), Минимум (Minimum), Среднее (Mean), Медиана (Median), Большинство (Majority), Меньшинство (Minority) и Сумма (Sum), если в качестве входных данных используется один растр, выходные значения ячеек будут такими же, как входные. Для Диапазона или Среднеквадратического отклонения все выходные значения будут равны 0. Для Разнообразия это будет 1.

• Если не отмечен параметр Обработать как многоканальный (для process_as_multiband задано SINGLE_BAND в Python), каждый канал входного многоканального растра будет обрабатываться отдельно - как одноканальный растр, и выходными данными будет тоже растр с одним каналом.

  
  Инструмент Статистика по ячейкам создает одноканальный выходной растр при обработке типа SINGLE_BAND.

• Если отмечен параметр Обработать как многоканальный (для process_as_multiband задано MULTI_BAND в Python), каждый входной многоканальный растр будет обрабатываться как многоканальный и выходными данными будет тоже многоканальный растр. Выходной растр также будет многозональным, если входные данные представляют собой комбинацию многоканального растра и констант. Количество каналов в каждом входном многоканальном растре должно быть одинаковым.

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

  
  Инструмент Статистика по ячейкам создает многоканальный выходной растр при обработке типа MULTI_BAND.

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

  Если во всех многомерных растрах есть одна переменная, но у неё разные названия, задайте переменную геообработки matchMultidimensionalVariable как False, чтобы выполнить операцию.

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

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной растр или постоянные значения	Перечень входных растров, для которых будет вычислена статистика для каждой ячейки в окне Анализ. В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды. Если отмечен параметр Обработать как многоканальный, то все многоканальные входные данные должны иметь одинаковое число каналов.	Raster Layer; Constant
Статистика наложения (Дополнительный)	Указывает тип вычисляемой статистики. Типом статистики по умолчанию является Среднее. Среднее—Будет рассчитано среднее значение входных данных. Большинство—Будет рассчитано большинство (наиболее часто встречающиеся) входное значение. Максимум—Будет вычислено максимальное (самое большое) из входных значений. Медиана—Будет рассчитана медиана входных данных. Минимум—Будет вычислено минимальное (самое маленькое) из входных значений. Меньшинство—Будет рассчитано меньшинство (наиболее редко встречающиеся) входное значение. Интервал—Будет рассчитан диапазон (разница между наибольшим и наименьшим значением) значений входных растров. Среднеквадратическое отклонение—Будет рассчитано среднеквадратическое отклонение входных данных. Сумма—Будет вычислена сумма (сумма всех значений) входных значений. Разнообразие—Будет вычислено разнообразие (число уникальных значений) входных значений.	String
Игнорировать значение NoData при вычислениях (Дополнительный)	Определяет, игнорируются ли в вычислениях статистики значения NoData. Отмечено – при обработке местоположений ячеек, если в любом из входных растров имеется NoData, это значение будет игнорироваться. Статистика будет вычислена только по ячейкам с валидными данными. Это значение по умолчанию Не отмечено – если обрабатываемая ячейка любого из входных растров имеет значение NoData, этому местоположению в выходном растре также будет присвоено значение NoData.	Boolean
Обработать как многоканальный (Дополнительный)	Задает способ обработки каналов входного многоканального растра. Не отмечено – каждый канал многоканального растра будет обработан отдельно как одноканальный растр. Это значение по умолчанию Отмечено – каждый многоканальный входной растр будут обрабатываться как многоканальный растр. Эта операция будет выполнятся для каждого канала из входного набора с использованием соответствующего номера канала для остальных входных данных.	Boolean

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

Подпись	Описание	Тип данных
Выходной растр	Выходной растр. Для каждой ячейки значение определяется путем применения заданного типа статистики к входным растрам в данном местоположении.	Raster

Python

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband})

Имя	Описание	Тип данных
in_rasters_or_constants [in_raster_or_constant,...]	Перечень входных растров, для которых будет вычислена статистика для каждой ячейки в окне Анализ. В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды. Если параметр processing_as_multiband задан как MULTI_BAND, то все многоканальные входные данные должны иметь одинаковое число каналов.	Raster Layer; Constant
statistics_type (Дополнительный)	Указывает тип вычисляемой статистики. MEAN—Будет рассчитано среднее значение входных данных. MAJORITY—Будет рассчитано большинство (наиболее часто встречающиеся) входное значение. MAXIMUM—Будет вычислено максимальное (самое большое) из входных значений. MEDIAN—Будет рассчитана медиана входных данных. MINIMUM—Будет вычислено минимальное (самое маленькое) из входных значений. MINORITY—Будет рассчитано меньшинство (наиболее редко встречающиеся) входное значение. RANGE—Будет рассчитан диапазон (разница между наибольшим и наименьшим значением) значений входных растров. STD—Будет рассчитано среднеквадратическое отклонение входных данных. SUM—Будет вычислена сумма (сумма всех значений) входных значений. VARIETY—Будет вычислено разнообразие (число уникальных значений) входных значений. Типом статистики по умолчанию является Среднее.	String
ignore_nodata (Дополнительный)	Определяет, игнорируются ли в вычислениях статистики значения NoData. DATA—При обработке местоположений ячеек, если в любом из входных растров имеется NoData, это значение будет игнорироваться. Статистика будет вычислена только по ячейкам с валидными данными. Это значение по умолчанию NODATA—Если обрабатываемая ячейка любого из входных растров имеет значение NoData, этому местоположению в выходном растре также будет присвоено значение NoData.	Boolean
process_as_multiband (Дополнительный)	Задает способ обработки каналов входного многоканального растра. SINGLE_BAND—Каждый канал многоканального растра будет обработан отдельно как одноканальный растр. Это значение по умолчанию MULTI_BAND—Каждый многоканальный входной растр будут обрабатываться как многоканальный растр. Эта операция будет выполнятся для каждого канала из входного набора с использованием соответствующего номера канала для остальных входных данных.	Boolean

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

Имя	Описание	Тип данных
out_raster	Выходной растр. Для каждой ячейки значение определяется путем применения заданного типа статистики к входным растрам в данном местоположении.	Raster

Пример кода

CellStatistics, пример 1 (окно Python)

В этом примере вычисляется стандартное отклонение для каждой ячейки на нескольких входных растрах грида, а результат представляется в виде растра IMG.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outCellStats = CellStatistics(["degs", "negs", "cost"], "STD", "DATA")
outCellStats.save("C:/sapyexamples/output/outcellstats.img")

CellStatistics, пример 2 (автономный скрипт)

В этом примере вычисляется диапазон по ячейкам по каналам для нескольких входных многоканальных растров и создается многоканальный выходной растр.

# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
#               and process as multiband.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"

# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"

# Execute CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")

# Save the output 
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")

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

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

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

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

• Basic: Обязательно Spatial Analyst или Image Analyst
• Standard: Обязательно Spatial Analyst или Image Analyst
• Advanced: Обязательно Spatial Analyst или Image Analyst