Вычислить статистику (пакетно) (Batch Calculate Statistics) (Управление данными (Data Management))
Краткая информация
Вычисляет статистику для нескольких наборов растровых данных.
Использование
-
Вычисление статистики позволяет приложениям ArcGIS должным образом растягивать и отображать растровые данные.
-
Коэффициент пропуска контролирует части наборов растровых данных, которые используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра.
-
При вычислении статистики по Esri Grid и форматам RADARSAT2 всегда используется коэффициент пропуска 1.
-
Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или ArcSDE базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по 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 или если оно будет искажать ваши вычисления.
Синтаксис
Параметр | Объяснение | Тип данных |
Input_Raster_Datasets [input_raster_dataset,...] |
Входной набор растровых данных. | Raster Dataset |
Number_of_columns_to_skip (дополнительно) |
Число пикселов по горизонтали между значениями. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящихся в файловой базе геоданных, отличаются от тех, которые хранятся в базе геоданных ArcSDE. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика. | Long |
Number_of_rows_to_skip (дополнительно) |
Число пикселов по вертикали между значениями. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящихся в файловой базе геоданных, отличаются от тех, которые хранятся в базе геоданных ArcSDE. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика. | Long |
Ignore_values [ignore_value,...] (дополнительно) |
Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию No Value (Нет значений). | Double |
Skip_Existing (дополнительно) | Укажите, будет ли вычисляться статистика только там, где она отсутствует, или создавать ее заново, даже если она существует.
| 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)