OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")
Использование
Для этого инструмента не имеет значения порядок входных растров.
Для типов статистики Максимум, Минимум, Среднее, Медиана, Большинство, Меньшинство, Процент и Сумма, если в качестве входных данных используется один растр, выходные значения ячеек будут такими же, как входные. Для типов Диапазон и Среднеквадратическое отклонение все выходные значения будут равняться 0. Для типа Разнообразие это будет 1.
Если параметр Обработать как многоканальный не отмечен ('process_as_multiband' установлен SINGLE_BAND в Python), каждый канал из многоканального входного растра будет обрабатываться отдельно как одноканальный растр, а выходным будет одноканальный растр.
Статистика по ячейкам создает одноканальный выходной растр при обработке типа SINGLE_BAND.
Если проверить параметр Обработать как многоканальный ('process_as_multiband' установлен на MULTI_BAND в Python), каждый многоканальный входной растр обрабатывается как многоканальный растр, а выходной растр будет многоканальным. Выходной растр также будет многоканальным, если входные данные представляют собой комбинацию многоканального растра и константы. Число каналов всех многоканальных растров должно быть одинаковым.
Инструмент будет выполнять операцию для каждого канала одного входного растра, используя соответствующий канал другого входного растра. Если один из входных растров является многоканальным, а другие входные данные - константа, инструмент выполнит операцию, используя постоянное значение для каждого канала многоканального входного растра.
Статистика по ячейкам создает многоканальный выходной растр при обработке как MULTI_BAND.
Если все входные данные представляют собой многомерные растровые данные с одинаковым количеством переменных, инструмент выполнит операцию для всех срезов с одинаковым значением измерения. Результатом будет многомерный растр в формате CRF. Переменные во входных данных должны иметь по крайней мере одно общее измерение и одно общее размерное значение для обработки этим инструментом, в противном случае произойдет ошибка.
Если все входные данные содержат одну переменную, но разные имена, снимите отметку Сопоставить многомерную переменную для среды геообработки (установите arcpy.env.matchMultidimensionalVariable = False в Python) перед выполнением операции.
Если одни или несколько входных данных являются многомерными растрами, а другие входные данные являются константами, инструмент выполнит операцию для всех срезов для всех переменных, используя значение константы, и выходными данными будет многомерный растр.
Для вычислений большинства и меньшинства при наличии равных (связанных) значений выходные данные будут представлять собой наименьшее из равных значений.
Если входной растр имеет прямоугольные ячейки, он будет обработан так, что выходные ячейки растра будут квадратными, со сторонами, равными среднему длины и ширины прямоугольника.
Перечень входных растров, для которых будет вычислена операция статистики для каждой ячейки в рамках окна анализа.
В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды.
Если отмечен параметр Обработать как многоканальный, то все многоканальные входные данные должны содержать одинаковое число каналов.
Raster Layer; Constant
Статистика наложения
(Дополнительный)
Задает вычисляемый тип статистики.
Среднее–Вычисляет среднее значение входных растров. Используется по умолчанию.
Большинство–Будет определено большинство (наиболее часто встречающееся) входное значение.
Максимум–Будет определено максимальное (наибольшее) значение во входных данных.
Медиана–Будет вычислено медианное значение входных растров.
Минимум–Будет определено минимальное (наименьшее) из входных значений.
Меньшинство–Будет определено реже всего встречающееся значение входных растров.
Процентиль–Будет вычислен процентиль входных данных. Девяностый процентиль вычисляется по умолчанию. Вы можете задать другие значения (от 0 до 100) с помощью параметра Значение процентиля.
Диапазон–Будет вычислен диапазон значений входных растров (разница между наибольшим и наименьшим значением).
Устанавливает, будут ли игнорироваться в вычислениях статистики значения NoData.
Отмечено–При обработке местоположений ячеек, если в любом из входных растров имеется NoData, это значение будет игнорироваться. Статистика будет вычислена только по ячейкам с корректными данными. Используется по умолчанию.
Не отмечено–Если обрабатываемая ячейка любого из входных растров имеет значение NoData, этому местоположению также будет присвоено значение NoData в выходном растре.
Boolean
Обработать как многоканальный
(Дополнительный)
Задает способ обработки каналов входного многоканального растра.
Отмечено–Каждый многоканальный растр обрабатывается как многоканальный. Операция будет выполняться для каждого канала одних входных данных, с использованием номера соответствующего канала других входных данных.
Не отмечено–Каждый канал многоканального растра обрабатывается отдельно, как одноканальный растр. Используется по умолчанию.
Boolean
Значение процентиля
(Дополнительный)
Значение процентиля, которое будет вычислено. Значение по умолчанию – 90, определяющее 90-й процентиль.
Значение может варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен минимуму в статистике, а 100-й - максимуму в статистике. Значение 50 даст, по существу, тот же результат, что и медиана в статистике.
Этот параметр доступен только в том случае, если для параметра Статистика наложения задано Процентиль.
Double
Тип интерполяции Процентиль
(Дополнительный)
Определяет метод интерполяции, который будет использоваться, когда указанное значение процентиля находится между двумя значениями входных ячеек.
Автоматическое определение–Если входные растры содержат целочисленные пикселы, используется метод Ближайший. Если входные растры содержат пикселы с плавающей точкой, используется метод Линейный. Используется по умолчанию.
Ближайший–Используется ближайшее доступное значение к желаемому процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре.
Линейный–Используется средневзвешенное значение двух окружающих значений из процентиля. В этом случае тип выходного пиксела - с плавающей точкой.
String
Возвращаемое значение
Подпись
Объяснение
Тип данных
Выходной растр
Выходной растр.
Для каждой ячейки значение определяется путем применения заданного типа статистики к входным растрам в данном местоположении.
Перечень входных растров, для которых будет вычислена операция статистики для каждой ячейки в рамках окна анализа.
В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды.
Если параметр processing_as_multiband задан как MULTI_BAND, то все многоканальные входные растры должны содержать одинаковое число каналов.
Raster Layer; Constant
statistics_type
(Дополнительный)
Задает вычисляемый тип статистики.
MEAN–Вычисляет среднее значение входных растров. Используется по умолчанию.
MAJORITY–Будет определено большинство (наиболее часто встречающееся) входное значение.
MAXIMUM–Будет определено максимальное (наибольшее) значение во входных данных.
MEDIAN–Будет вычислено медианное значение входных растров.
MINIMUM–Будет определено минимальное (наименьшее) из входных значений.
MINORITY–Будет определено реже всего встречающееся значение входных растров.
PERCENTILE–Будет вычислен процентиль входных данных. Девяностый процентиль вычисляется по умолчанию. Вы можете задать другие значения (от 0 до 100) с помощью параметра percentile_value.
RANGE–Будет вычислен диапазон значений входных растров (разница между наибольшим и наименьшим значением).
Устанавливает, будут ли игнорироваться в вычислениях статистики значения NoData.
DATA–При обработке местоположений ячеек, если в любом из входных растров имеется NoData, это значение будет игнорироваться. Статистика будет вычислена только по ячейкам с корректными данными. Используется по умолчанию.
NODATA–Если обрабатываемая ячейка любого из входных растров имеет значение NoData, этому местоположению также будет присвоено значение NoData в выходном растре.
Boolean
process_as_multiband
(Дополнительный)
Задает способ обработки каналов входного многоканального растра.
MULTI_BAND–Каждый многоканальный растр обрабатывается как многоканальный. Операция будет выполняться для каждого канала одних входных данных, с использованием номера соответствующего канала других входных данных.
SINGLE_BAND–Каждый канал многоканального растра обрабатывается отдельно, как одноканальный растр. Используется по умолчанию.
Boolean
percentile_value
(Дополнительный)
Значение процентиля, которое будет вычислено. Значение по умолчанию – 90, определяющее 90-й процентиль.
Значение может варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен минимуму в статистике, а 100-й - максимуму в статистике. Значение 50 даст, по существу, тот же результат, что и медиана в статистике.
Этот параметр поддерживается только в том случае, если для параметра statistics_type установлено значение PERCENTILE.
Double
percentile_interpolation_type
(Дополнительный)
Определяет метод интерполяции, который будет использоваться, когда указанное значение процентиля находится между двумя значениями входных ячеек.
AUTO_DETECT–Если входные растры содержат целочисленные пикселы, используется метод NEAREST. Если входные растры содержат пикселы с плавающей точкой, используется метод LINEAR. Используется по умолчанию.
NEAREST–Используется ближайшее доступное значение к желаемому процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре.
LINEAR–Используется средневзвешенное значение двух окружающих значений из процентиля. В этом случае тип выходного пиксела - с плавающей точкой.
String
Возвращаемое значение
Имя
Объяснение
Тип данных
out_raster
Выходной растр.
Для каждой ячейки значение определяется путем применения заданного типа статистики к входным растрам в данном местоположении.
Raster
Пример кода
CellStatistics, пример 1 (окно Python)
В этом примере вычисляется стандартное отклонение для каждой ячейки на нескольких входных растрах грида, а результат представляется в виде растра IMG.
В этом примере вычисляется диапазон по ячейкам по каналам для нескольких входных многоканальных растров и создается многоканальный выходной растр.
# Name: CellStatistics_Ex_standalone.py
# Description: Calculates a per-cell statistic from multiple multiband rasters
# and process as multiband.
# Requirements: Image Analyst extension
# Import system modules
import arcpy
from arcpy.ia import *
# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"
# Set the local variables
inRaster01 = "degs_MB"
inRaster02 = "negs_MB"
inRaster03 = "cost_MB"
# Run CellStatistics
outCellStatistics = CellStatistics([inRaster01, inRaster02, inRaster03], "RANGE", "NODATA", "MULTI_BAND")
# Save the output
outCellStatistics.save("C:/sapyexamples/output/cellstats_MB.tif")
