Статистика набора каналов (Инструменты Spatial Analyst)

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

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

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

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

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

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

Матрица ковариации представляет дисперсии всех каналов растра вдоль диагонали, которая проходит из верхнего левого в нижний правый угол матрицы; остальные значения - это ковариации между всеми каналами растра. Матрица корреляции содержит коэффициенты корреляции для всех сочетаний двух входных каналов.
При вычислении матрицы ковариации для всех входных ячеек, в которых установлено NoData, используется среднее значение по ячейкам.
Если отмечен параметр Вычислить гистограмму, статистика гистограммы будет добавлена в выходной файл статистики. При желании можно создать таблицу выходной гистограммы и диаграмму выходной гистограммы, если они указаны.
В таблице выходной гистограммы поля l<n>_count записывают количество ячеек в слое <n>, которые попадают в определенный бин. В полях l<n>_percent регистрируется процент ячеек, указанных в поле количества, среди общего числа ячеек слоя <n> в области анализа.
Статистика записывается в выходной файл в формате значений, разделенных запятыми (CSV), или в формате markdown. Расширение выходного файла должно быть .txt, .md, .csv или .asc.
Вся рассчитанная этим инструментом статистика будет отображаться на панели История геообработки, за исключением гистограммы. Если таблица гистограммы и диаграмма будут созданы, они появятся в разделе Автономные таблицы на панели Содержание. Более подробно см. Работа с автономными таблицами в картах.

Подпись	Объяснение	Тип данных
Входные каналы растра	Входные каналы растров. Они могут быть целочисленными или с плавающей точкой.	Raster Layer
Выходной файл статистики	Выходной текстовой файл или файл markdown, содержащий статистику. Требуется расширение `.txt`, `.md`, `.csv` или `.asc`. По умолчанию – `.txt`. Выходной файл статистики использует формат CSV, за исключением случаев, когда указано расширение `.md`. В этом случае выходной файл будет в формате markdown.	File
Вычислить ковариационную и корреляционную матрицу (Дополнительный)	Определяет, будут ли вычислены матрицы ковариации и корреляции. Отмечено–Помимо основных статистических показателей, вычисляемых, когда этот параметр не отмечен, будут вычислены матрицы ковариации и корреляции. Не отмечено–Для каждого слоя будут вычислены только основные статистические показатели (минимум, максимум, среднее и стандартное отклонение). Используется по умолчанию.	Boolean
Вычислить гистограмму (Дополнительный)	Задает, будет ли вычислена статистика гистограммы. Если этот параметр отмечен, параметры Число бинов гистограммы, Таблица выходной гистограммы и Имя выходной гистограммы будут поддерживаться. Когда этот параметр не отмечен, перечисленные параметры не поддерживаются. Отмечено–Статистика гистограммы будет вычислена. Не отмечено–Статистика гистограммы не будет вычисляться. Используется по умолчанию.	Boolean
Число бинов гистограммы (Дополнительный)	Указывает число бинов гистограммы, которые будут использоваться при расчете гистограммы. Значение по умолчанию - 256. Минимально допустимое значение - 1. Максимально допустимое значение - 4096. Значение этого параметра следует установить в соответствии с входными данными и приложением анализа.	Long
Таблица выходной гистограммы (Дополнительный)	Выходная таблица, которая будет содержать статистику гистограммы для всех входных каналов. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию выходными данными будет таблица базы геоданных в рабочей области базы геоданных, и таблица dBASE (файл `.dbf`), если рабочая область представляет собой папку с файлами. Для создания таблицы выходной гистограммы необходимо отметить параметр Вычислить гистограмму.	Table
Имя выходной гистограммы (Дополнительный)	Имя выходной гистограммы для отображения. Эта гистограмма будет перечислена на панели Содержание в разделе Автономные таблицы. Для создания диаграммы выходной гистограммы должно быть указано значение параметра Таблица выходной гистограммы.	String

BandCollectionStats(in_raster_bands, out_stat_file, {compute_matrices}, {compute_histogram}, {number_bins}, {out_histogram_table}, {out_histogram})

Имя	Объяснение	Тип данных
in_raster_bands [in_raster_band,...]	Входные каналы растров. Они могут быть целочисленными или с плавающей точкой.	Raster Layer
out_stat_file	Выходной текстовой файл или файл markdown, содержащий статистику. Требуется расширение `.txt`, `.md`, `.csv` или `.asc`. По умолчанию – `.txt`. Выходной файл статистики использует формат CSV, за исключением случаев, когда указано расширение `.md`. В этом случае выходной файл будет в формате markdown.	File
compute_matrices (Дополнительный)	Определяет, будут ли вычислены матрицы ковариации и корреляции. `DETAILED`–Помимо основных статистических показателей, рассчитанных с помощью опции `BRIEF`, будут также вычислены матрицы ковариации и корреляции. `BRIEF`–Для каждого слоя будут вычислены только основные статистические показатели (минимум, максимум, среднее и стандартное отклонение). Используется по умолчанию.	Boolean
compute_histogram (Дополнительный)	Задает, будет ли вычислена статистика гистограммы. Когда этот параметр установлен на `COMPUTE_HISTOGRAM`, будут поддерживаться параметры `number_bins`, `out_histogram_table` и `out_histogram`. Когда этот параметр установлен на `NO_HISTOGRAM`, другие параметры не будут поддерживаться. `COMPUTE_HISTOGRAM`–Статистика гистограммы будет вычислена. `NO_HISTOGRAM`–Статистика гистограммы не будет вычисляться. Используется по умолчанию.	Boolean
number_bins (Дополнительный)	Указывает число бинов гистограммы, которые будут использоваться при расчете гистограммы. Значение по умолчанию - 256. Минимально допустимое значение - 1. Максимально допустимое значение - 4096. Значение этого параметра следует установить в соответствии с входными данными и приложением анализа.	Long
out_histogram_table (Дополнительный)	Выходная таблица, которая будет содержать статистику гистограммы для всех входных каналов. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию выходными данными будет таблица базы геоданных в рабочей области базы геоданных, и таблица dBASE (файл `.dbf`), если рабочая область представляет собой папку с файлами. Для создания таблицы выходной гистограммы необходимо установить параметр `compute_histogram` на `COMPUTE_HISTOGRAM`.	Table
out_histogram (Дополнительный)	Имя выходной гистограммы для отображения. Для создания диаграммы выходной гистограммы должно быть указано значение параметра `out_histogram_table`.	String

Пример кода

BandCollectionStats пример 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", "COMPUTE_HISTOGRAM", "256", "c:/sapyexamples/output/outtable01.dbf", "histogram01")

BandCollectionStats пример 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"
outHistTable = "C:/sapyexamples/output/output.gdb/outtable01"

# Run BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)

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

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

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