Наверх

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

В этом разделе

  1. Краткая информация
  2. Иллюстрация
  3. Использование
  4. Параметры
  5. Параметры среды
  6. Информация о лицензиях

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

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

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

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

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

Learn more about how Cell Statistics works

Иллюстрация

Example Cell Statistics tool input and output values
OutRas = CellStatistics([InRas1, InRas2, InRas3], "SUM", "NODATA", "SINGLE_BAND")

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

  • The order of the input rasters is irrelevant for this tool.

  • Для типов статистики Максимум, Минимум, Среднее, Медиана, Большинство, Меньшинство, Процентиль и Сумма, если в качестве входных данных используется один растр, выходные значения ячеек будут такими же, как входные. Для Диапазона или Среднеквадратического отклонения все выходные значения будут равны 0. Для Разнообразия это будет 1.

  • If the Process as multiband parameter is unchecked (process_as_multiband is set to SINGLE_BAND in Python), each band from a multiband raster input will be processed separately as a single band raster, and the output will be a single band raster.

    Single-band output when processed as SINGLE_BAND
    The Cell Statistics tool creates a single-band output when processed as SINGLE_BAND.

  • If the Process as multiband parameter is checked (process_as_multiband is set to MULTI_BAND in Python), each multiband raster input will be processed as a multiband raster, and the output will be a multiband raster. Выходной растр также будет многоканальным, если входные данные представляют собой комбинацию многоканального растра и констант. Количество каналов в каждом входном многоканальном растре должно быть одинаковым.

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

    Multiband output when processed as MULTI_BAND.
    The Cell Statistics tool creates a multiband output when processed as MULTI_BAND.

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

    Если все входные данные имеют одну переменную, но разные имена, снимите отметку Сопоставить многомерную переменную для среды геообработки (установите arcpy.env.matchMultidimensionalVariable = False в Python) перед выполнением операции.

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

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

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

Параметры

ДиалогPython

ПодписьОписаниеТип данных
Входной растр или постоянные значения

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

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

Если отмечен параметр Обработать как многоканальный, то все многоканальные входные данные должны иметь одинаковое число каналов.

Raster Layer; Constant
Статистика наложения
(Дополнительный)

Указывает тип вычисляемой статистики.

Типом статистики по умолчанию является Среднее.

  • Среднее—Будет рассчитано среднее значение входных данных. Это значение по умолчанию
  • Большинство—Будет определяться наиболее часто встречающееся входное значение.
  • Максимум—Будет определяться максимальное (наибольшее) из входных значений.
  • Медиана—Будет рассчитана медиана входных данных.
  • Минимум—Будет определяться минимальное (наименьшее) из входных значений.
  • Меньшинство—Будет определяться реже всего встречающееся значение входных растров.
  • Процентиль—Процентиль входных данных для вычисления. Девяностый процентиль вычисляется по умолчанию. Вы можете указать другие значения (от 0 до 100), используя параметр Значение процентиля.
  • Диапазон—Будет рассчитан диапазон (разница между наибольшим и наименьшим значением) значений входных растров.
  • Среднеквадратическое отклонение—Будет рассчитано среднеквадратическое отклонение входных данных.
  • Сумма—Будет вычислена сумма (сумма всех значений) входных значений.
  • Разнообразие—Будет вычислено разнообразие (число уникальных значений) входных значений.
String
Игнорировать значение NoData при вычислениях
(Дополнительный)

Определяет, игнорируются ли в вычислениях статистики значения NoData.

  • Отмечено – при обработке местоположений ячеек, если в любом из входных растров имеется NoData, это значение будет игнорироваться. Статистика будет вычислена только по ячейкам с валидными данными. Это значение по умолчанию
  • Не отмечено – если обрабатываемая ячейка любого из входных растров имеет значение NoData, этому местоположению в выходном растре также будет присвоено значение NoData.
Boolean
Обработать как многоканальный
(Дополнительный)

Задает способ обработки каналов входного многоканального растра.

  • Не отмечено – каждый канал многоканального растра будет обработан отдельно как одноканальный растр. Это значение по умолчанию
  • Отмечено – каждый многоканальный входной растр будут обрабатываться как многоканальный растр. Эта операция будет выполнятся для каждого канала из входного набора с использованием соответствующего номера канала для остальных входных данных.
Boolean
Значение процентиля
(Дополнительный)

Будет вычислено значение процентиля. Значение по умолчанию – 90, для 90-го процентиля.

Значение может варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимуму в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике.

Этот параметр доступен, только если для параметра Статистика наложения задано Процентиль.

Double
Тип интерполяции процентиля
(Дополнительный)

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

  • Автоопределение—Если входные растры содержат целочисленные пикселы, используется метод Ближайший. Если входные растры содержат пикселы с плавающей точкой, используется метод Линейная. Это значение по умолчанию
  • Ближайший—Будет использоваться ближайшее доступное значение к заданному процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре.
  • Линейный—Используется средневзвешенное значение двух окружающих значений из процентиля. В этом случае тип выходного пиксела будет с плавающей точкой.
String

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

ПодписьОписаниеТип данных
Выходной растр

Выходной растр.

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

Raster

CellStatistics(in_rasters_or_constants, {statistics_type}, {ignore_nodata}, {process_as_multiband}, {percentile_value}, {percentile_interpolation_type})
ИмяОписаниеТип данных
in_rasters_or_constants
[in_raster_or_constant,...]

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

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

If the processing_as_multiband parameter is set to MULTI_BAND, all multiband inputs should have an equal number of bands.

Raster Layer; Constant
statistics_type
(Дополнительный)

Указывает тип вычисляемой статистики.

  • MEAN—Будет рассчитано среднее значение входных данных. Это значение по умолчанию
  • MAJORITY—Будет определяться наиболее часто встречающееся входное значение.
  • MAXIMUM—Будет определяться максимальное (наибольшее) из входных значений.
  • MEDIAN—Будет рассчитана медиана входных данных.
  • MINIMUM—Будет определяться минимальное (наименьшее) из входных значений.
  • MINORITY—Будет определяться реже всего встречающееся значение входных растров.
  • PERCENTILE—Процентиль входных данных для вычисления. Девяностый процентиль вычисляется по умолчанию. You can specify other values (from 0 to 100) using the percentile_value parameter.
  • RANGE—Будет рассчитан диапазон (разница между наибольшим и наименьшим значением) значений входных растров.
  • STD—Будет рассчитано среднеквадратическое отклонение входных данных.
  • SUM—Будет вычислена сумма (сумма всех значений) входных значений.
  • VARIETY—Будет вычислено разнообразие (число уникальных значений) входных значений.

The default statistic type is MEAN.

String
ignore_nodata
(Дополнительный)

Определяет, игнорируются ли в вычислениях статистики значения NoData.

  • DATA—При обработке местоположений ячеек, если в любом из входных растров имеется NoData, это значение будет игнорироваться. Статистика будет вычислена только по ячейкам с валидными данными. Это значение по умолчанию
  • NODATA—Если обрабатываемая ячейка любого из входных растров имеет значение NoData, этому местоположению в выходном растре также будет присвоено значение NoData.
Boolean
process_as_multiband
(Дополнительный)

Задает способ обработки каналов входного многоканального растра.

  • SINGLE_BAND—Каждый канал многоканального растра будет обработан отдельно как одноканальный растр. Это значение по умолчанию
  • MULTI_BAND—Каждый многоканальный входной растр будут обрабатываться как многоканальный растр. Эта операция будет выполнятся для каждого канала из входного набора с использованием соответствующего номера канала для остальных входных данных.
Boolean
percentile_value
(Дополнительный)

Будет вычислено значение процентиля. Значение по умолчанию – 90, для 90-го процентиля.

Значение может варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимуму в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике.

This parameter is only supported if the statistics_type parameter is set to PERCENTILE.

Double
percentile_interpolation_type
(Дополнительный)

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

  • AUTO_DETECT—If the input rasters are of integer pixel type, the NEAREST method will be used. If the input rasters are of floating point pixel type, the LINEAR method will be used. Это значение по умолчанию
  • NEAREST—Будет использоваться ближайшее доступное значение к заданному процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре.
  • LINEAR—Используется средневзвешенное значение двух окружающих значений из процентиля. В этом случае тип выходного пиксела будет с плавающей точкой.
String

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

ИмяОписаниеТип данных
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

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

  • Обзор группы инструментов Локальные
  • Поиск инструмента геообработки
  • Статистика по ячейкам

Отзыв по этому разделу?

В этом разделе
  1. Краткая информация
  2. Иллюстрация
  3. Использование
  4. Параметры
  5. Параметры среды
  6. Информация о лицензиях