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

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

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

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

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

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

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

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

Выходной набор растровых данных.

Набор растровых данных

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

Выходной набор растровых данных.

Набор растровых данных

Пример кода

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")