Статистика набора каналов (Spatial Analyst)

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

Сводка

Вычисляет статистику для набора каналов растра.

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

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

  • Если многоканальный растр указан как один из входных для параметра Входные каналы растра (in_raster_bands в Python), будут обработаны все каналы.

    Чтобы обработать выбранные каналы многоканального растра, сначала создайте новый набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы, затем укажите полученный набор как Входной растр (in_raster_bands в Python).

  • Каналы растра должны иметь общую область пересечения. При ее отсутствии возникнет ошибка и выходные данные созданы не будут.

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

  • Для параметра Вычислить матрицы ковариации и корреляции применяемая по умолчанию (выключенная) настройка (BRIEF в скрипте) означает, что вычислены будут только минимум, максимум, среднее значение и стандартное отклонение входных каналов. Чтобы вычислить, помимо этой статистики, матрицы ковариации и корреляции, включите этот параметр в диалоговом окне инструмента (либо используйте в скрипте DETAILED).

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

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

  • Статистика записывается в выходной файл текстового формата ASCII. Расширение выходного файла должно быть .txt.

Синтаксис

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices})
ParameterОбъяснениеТип данных
in_raster_bands
[in_raster_band,...]

Входные каналы растров.

Они могут быть целочисленными или с плавающей точкой.

Raster Layer
out_stat_file

Выходной ASCII-файл, содержащий статистику.

Требуется расширение .txt.

File
compute_matrices
(Дополнительный)

Определяет, будут ли вычислены матрицы ковариации и корреляции.

  • BRIEF Для каждого слоя будут вычислены только основные статистические показатели (минимум, максимум, среднее и стандартное отклонение). Используется по умолчанию.
  • DETAILED Помимо стандартной статистики, вычисляемой при использовании опции {BRIEF}, будут также определены матрицы ковариации и корреляции.
Boolean

Пример кода

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

В этом примере вычисляется статистику для набора каналов растра.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
BandCollectionStats("redlands", "c:/sapyexamples/output/redbandstats.txt", "BRIEF")
BandCollectionStatistics, пример 2 (автономный скрипт)

В этом примере вычисляется статистику для набора каналов растра.

# Name: BandCollectionStats_Ex_02.py
# Description: Calculates the statistics for a set of raster bands.
# 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
inRasterBand1 = "sb/sbc1"
inRasterBand2 = "sb/sbc2"
outStatFile = "C:/sapyexamples/output/bandstatfile.txt"

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

# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED")

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

  • Basic: Требуется Spatial Analyst
  • Standard: Требуется Spatial Analyst
  • Advanced: Требуется Spatial Analyst

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