Вычислить статистику (Управление данными)

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

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

Статистика необходима для наборов растровых данных и данных мозаики для выполнения определенных задач, таких как применение растяжки или классификации данных.

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

• Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 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 или если оно будет искажать ваши вычисления.

• При вычислении статистики по Esri Grid и форматам RADARSAT2 всегда используется коэффициент пропуска 1.

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входной набор растровых данных	Входной набор растровых данных или набор данных мозаики.	Mosaic Dataset; Mosaic Layer; Raster Dataset
Коэффициент пропуска по X (Дополнительный)	Число пикселов по горизонтали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика.	Long
Коэффициент пропуска по Y (Дополнительный)	Число пикселов по вертикали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика.	Long
Игнорировать значения (Дополнительный)	Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию нет значения, либо применяется последнее игнорированное значение.	Long
Пропустить существующие (Дополнительный)	Укажите, будет ли вычисляться статистика только тогда, когда она отсутствует, или создавать ее заново, даже если она существует. Не отмечено – статистика будет вычислена даже если она уже существует, а существующая статистика будет перезаписана. Используется по умолчанию. Отмечено – статистика будет вычислена, только если она еще не существует.	Boolean
Область интереса (Дополнительный)	Область в наборе данных, которая будет использована для расчета статистики, чтобы не использовать для расчета весь набор данных. Можно выбрать класс пространственных объектов или создать график полигонов на экране.	Feature Set

Производные выходные данные

Подпись	Описание	Тип данных
Обновленный входной набор растровых данных	Выходной набор растровых данных.	Raster Dataset

Python

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})

Имя	Описание	Тип данных
in_raster_dataset	Входной набор растровых данных или набор данных мозаики.	Mosaic Dataset; Mosaic Layer; Raster Dataset
x_skip_factor (Дополнительный)	Число пикселов по горизонтали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше нуля и меньше или равно числу столбцов растра. По умолчанию используется 1 или последний коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика.	Long
y_skip_factor (Дополнительный)	Число пикселов по вертикали между значениями. Коэффициент пропуска контролирует часть растра, которая используются при вычислении статистики. Значение коэффициента определяет горизонтальный и вертикальный коэффициенты пропуска, значение 1 означает, что будет учтен каждый пиксел, а значение 2 – каждый второй пиксел. Коэффициент пропуска может варьироваться от 1 до числа, равного количеству столбцов/строк растра. Значение должно быть больше 0 и меньше или равно общему числу строк в наборе растровых данных. По умолчанию 1 или последний использовавшийся коэффициент пропуска. Коэффициенты пропуска для наборов растровых данных, хранящиеся в файловой или многопользовательской базе данных могут сильно варьировать. Во-первых, если коэффициенты пропуска по x и y различаются, для этих двух коэффициентов пропуска по x и y будет использоваться тот, который меньше. Во-вторых, коэффициент пропуска связан с уровнем пирамидного слоя, который наиболее точно соответствует выбранному коэффициенту пропуска. Если значение коэффициента пропуска не равно количеству пикселов в уровне пирамидного слоя, количество округляется в меньшую сторону до следующего уровня пирамидного слоя, и используется его статистика.	Long
ignore_values [ignore_value,...] (Дополнительный)	Значения пикселов, которые не будут включены в вычисление статистики. По умолчанию нет значения, либо применяется последнее игнорированное значение.	Long
skip_existing (Дополнительный)	Укажите, будет ли вычисляться статистика только тогда, когда она отсутствует, или создавать ее заново, даже если она существует. OVERWRITE—Статистика будет вычислена даже если она уже существует, а существующая статистика будет перезаписана. Используется по умолчанию. SKIP_EXISTING—Статистика будет вычислена, только если она еще не существует.	Boolean
area_of_interest (Дополнительный)	Класс пространственных объектов, представляющий область в наборе данных, на основе которой будет рассчитываться статистика, чтобы не использовать для расчета весь набор данных.	Feature Set

Производные выходные данные

Имя	Описание	Тип данных
out_raster	Выходной набор растровых данных.	Raster Dataset

Пример кода

CalculateStatistics, пример 1 (окно Python)

Это пример Python для функции CalculateStatistics.

import arcpy
arcpy.CalculateStatistics_management(
     "C:/data/image.tif", "5", "5", "0;255", 
     "SKIP_EXISTING", "c:/data/aoi.shp")

Инструмент CalculateStatistics, пример 2 (автономный скрипт)

Это пример скрипта Python для функции CalculateStatistics.

# Calculate Statistics for single raster dataset

import arcpy
arcpy.env.workspace = "C:/Workspace"
    
arcpy.CalculateStatistics_management("image.tif", "4", "6", "0;255;21")

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

Текущая рабочая область, Коэффициент параллельной обработки, Статистика растра, Временная рабочая область

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

• Basic: Да
• Standard: Да
• Advanced: Да