| Подпись | Описание | Тип данных |
Входные каналы растра | Входные каналы растров. Они могут быть целочисленными или с плавающей точкой. | Raster Layer |
Выходной файл статистики | Выходной текстовой файл или файл markdown, содержащий статистику. Требуется расширение .txt, .md, .csv или .asc. По умолчанию – .txt. Выходной файл статистики использует формат CSV, за исключением случаев, когда указано расширение .md. В этом случае выходной файл будет в формате markdown. | File |
Вычислить ковариационную и корреляционную матрицу (Дополнительный) | Определяет, будут ли вычислены матрицы ковариации и корреляции.
| Boolean |
Вычислить гистограмму (Дополнительный) | Задает, будет ли вычислена статистика гистограммы.
Если этот параметр отмечен, параметры Число бинов гистограммы, Таблица выходной гистограммы и Имя выходной гистограммы будут включены для дополнительных опций. | Boolean |
Число бинов гистограммы (Дополнительный) | Указывает число бинов гистограммы, которые будут использоваться при расчете гистограммы. Значение по умолчанию - 256. Минимально допустимое значение - 1. Максимально допустимое значение - 4096. Значение этого параметра следует установить в соответствии с входными данными и приложением анализа. | Long |
Таблица выходной гистограммы (Дополнительный) | Выходная таблица, которая будет содержать статистику гистограммы для всех входных каналов. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию выходными данными будет таблица базы геоданных в рабочей области базы геоданных, и таблица dBASE (файл .dbf), если рабочая область представляет собой папку с файлами. Для создания таблицы выходной гистограммы необходимо отметить параметр Вычислить гистограмму. | Table |
Имя выходной гистограммы (Дополнительный) | Имя выходной гистограммы для отображения. Эта гистограмма будет перечислена на панели Содержание в разделе Автономные таблицы. Для создания диаграммы выходной гистограммы должно быть указано значение параметра Таблица выходной гистограммы. | String |
Доступно с лицензией 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.
Вся статистика, рассчитанная этим инструментом, будет отображаться на панели История геообработки, за исключением гистограммы. Если таблица гистограммы и диаграмма будут созданы, они появятся в разделе Автономные таблицы на панели Содержание. Более подробно см. Работа с автономными таблицами в картах.
Параметры
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 (Дополнительный) | Определяет, будут ли вычислены матрицы ковариации и корреляции.
| Boolean |
compute_histogram (Дополнительный) | Задает, будет ли вычислена статистика гистограммы.
Когда этот параметр установлен на COMPUTE_HISTOGRAM, будут поддерживаться параметры number_bins, out_histogram_table и out_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 |
Пример кода
В этом примере вычисляется статистику для набора каналов растра.
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")В этом примере вычисляется статистику для набора каналов растра.
# 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"
# Execute BandCollectionStats
BandCollectionStats([inRasterBand1, inRasterBand2], outStatFile, "DETAILED", "COMPUTE_HISTOGRAM", "256", outHistTable)Параметры среды
Информация о лицензиях
- Basic: Обязательно Spatial Analyst
- Standard: Обязательно Spatial Analyst
- Advanced: Обязательно Spatial Analyst