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

Сводка

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

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

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

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

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

Синтаксис

arcpy.management.CalculateStatistics(in_raster_dataset, {x_skip_factor}, {y_skip_factor}, {ignore_values}, {skip_existing}, {area_of_interest})
ParameterОбъяснениеТип данных
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

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

NameОбъяснениеТип данных
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")

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

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

Связанные разделы