Статистика набора каналов

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

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

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

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

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

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

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

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

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

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

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

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

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

  • При использовании диалогового окна инструмента выберите многоканальный растр с помощью кнопки обзора , расположенной рядом с пунктом Каналы входного растра, откройте растр и выберите нужные каналы.
  • Если многоканальный растр является слоем в Таблице содержания, можно использовать инструмент Создать растровый слой, чтобы создать новый многоканальный слой, содержащий только нужные каналы.
  • Можно также создать новый набор данных, содержащий только нужные каналы, используя для этого инструмент Объединить каналы (Composite Bands), входными данными для которого будет являться полученный набор данных.
  • В Python нужные каналы можно указать как список напрямую в параметре инструмента.

Синтаксис

BandCollectionStats (in_raster_bands, out_stat_file, {compute_matrices})

Параметр	Объяснение	Тип данных
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")

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

• Текущая рабочая область (Current Workspace)
• Временная рабочая область (Scratch Workspace)

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

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