Сводка
Вычисляет статистику для нескольких наборов растровых данных.
Использование
Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра.
При вычислении статистики по Esri Grid и форматам RADARSAT2 всегда используется коэффициент пропуска 1.
Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не соответствует количеству пикселов пирамидного слоя (например, если коэффициент пропуска – 5 и ближайший уровень пирамидного слоя, 4 x 4 пикселов, равен 2), программное обеспечение округлит значение коэффициента в меньшую сторону до ближайшего пирамидного слоя (в приведенном примере – до 2) и это значение будет использовано в качестве коэффициента пропуска.
Коэффициент пропуска используется не для всех форматов растров. Форматы растров, которые будут вычислять статистику и пользоваться коэффициентом пропуска, включают TIFF, IMG, NITF, DTED, RAW, ADRG, CIB, CADRG/ECRG, DIGEST, GIS, LAN, CIT, COT, ERMapper, ENVI DAT, BIL, BIP, BSQ и базу геоданных.
Опция Игнорировать значения позволяет исключить определенное значение из вычисления статистики. Вам может понадобиться игнорировать значение, если это значение NoData или если оно будет искажать ваши вычисления.
Синтаксис
arcpy.management.BatchCalculateStatistics(Input_Raster_Datasets, {Number_of_columns_to_skip}, {Number_of_rows_to_skip}, {Ignore_values}, {Skip_Existing})| Parameter | Объяснение | Тип данных |
Input_Raster_Datasets [input_raster_dataset,...] | Входной набор растровых данных. | Raster Dataset |
Number_of_columns_to_skip (Дополнительный) | Число пикселов по горизонтали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика. | Long |
Number_of_rows_to_skip (Дополнительный) | Число пикселов по вертикали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика. | Long |
Ignore_values [ignore_value,...] (Дополнительный) | Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию No Value (Нет значений). | Double |
Skip_Existing (Дополнительный) | Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует.
| Boolean |
Производные выходные данные
| Name | Объяснение | Тип данных |
| Batch_Calculate_Statistics_Succeeded | Информирует, было ли выполнение инструмента успешным. | Boolean |
Пример кода
Это пример скрипта Python для BatchCalculateStatistics.
import arcpy
arcpy.BatchCalculateStatistics_management(
"C:/data/img1.tif;C:/data/img2.jp2",
"5", "5", "0;255", "SKEP_EXISTING")Это пример скрипта Python для BatchCalculateStatistics.
#Calculate Statistics for multiple raster datasets with
#multiple ignore values.
#Skip datasets that already have the statistics.
import arcpy
arcpy.env.workspace = "C:/Workspace"
inras = "image1.tif;image2.img;fgdb.gdb/image3"
skipcol = "5"
skiprow = "5"
ignoreval = "0;255;21"
skipexist = "SKIP_EXISTING"
arcpy.BatchCalculateStatistics_management(
inras, skipcol, skiprow, ignoreval,skipexist)Информация о лицензиях
- Basic: Да
- Standard: Да
- Advanced: Да