Зональная статистика (Image Analyst)

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

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

Подробнее о том, как работают инструменты зональной статистики

Иллюстрация

Иллюстрация инструмента Зональная статистика
OutRas = ZonalStatistics(ZoneRas, "VALUE", ValRas, "MINIMUM", "DATA", "CURRENT_SLICE")

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

  • Зона определяется как все области входных данных, имеющие одно значение. Области не обязательно должны быть непрерывными. Для входных данных зон могут использоваться и растры и объекты.

  • Если Входные растровые или векторные данные зоны (in_zone_data в Python) являются растром, это должен быть целочисленный растр.

  • Если Входные растровые или векторные данные зоны векторные, они будут конвертированы в растр с использованием размера ячейки и выравнивания ячеек из параметра Входной растр значений (in_value_raster в Python).

  • Если размер или выравнивание ячеек в параметрах Входные растровые или векторные данные зон и Входной растр значений различаются, внутренне будет использоваться значение Входного растр значений для получения размера ячейки и растра замыкания. В обоих случаях перед выполнением операции зонирования будет вызвано внутреннее вычисление пикселов.

    Если у входного растра значений и растра зон одинаковый размер ячейки и ячейки выровнены, они будут использованы напрямую в инструменте - без пересчета значений во время работы инструмента.

  • Если Входные растровые или векторные данные зон являются объектами, все объекты зон, которые не пересекаются с центрами ячеек растра значений, не будут конвертироваться во внутренний растр зон. В результате, эти зоны не будут представлены в выходных данных. Вы можете управлять этим поведением, задав соответствующее значение для параметра среды размер ячеек:, что позволит сохранить желательный уровень детализации зон объектов, и задать его в параметрах среды анализа.

  • Если Входные растровые или векторные данные зоны представлены точечными объектами, в каждой конкретной ячейке входного растра значений может быть больше одной точки. Для таких ячеек значение зоны определяется точкой с наименьшим значением ObjectID (например, OID или FID).

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

    Альтернативный метод заключается в обработке зональной статистики итеративно для каждой из полигональных зон с последующим сопоставлением результатов.

  • При задании значения Входные растровые или векторные данные зон по умолчанию первое доступное целочисленное или текстовое поле выбирается полем зоны. Если других допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).

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

    Если тип данных относится к целочисленным, то для вычисления арифметической статистики поддерживаются следующие варианты: Среднее, Большинство, Число большинства, Процент большинства, Максимум, Медиана, Минимум, Меньшинство, Число меньшинства, Процент меньшинства, Процентиль, Диапазон, Среднеквадратическое отклонение, Сумма и Разнообразие. Для вычисления круговой статистики поддерживаются такие варианты, как Среднее, Большинство, Меньшинство, Среднеквадратическое отклонение и Разнообразие.

    Если данные с плавающей точкой, вычисление арифметической статистики поддерживает следующие варианты: Среднее, Максимум, Медиана, Минимум, Процентиль, Диапазон, Среднеквадратическое отклонение и Сумма. Вычисление круговой статистики поддерживает опции Среднее и Среднеквадратическое отклонение.

  • Для вычислений Большинства и Меньшинства, если есть привязка, выходные данные определяются наименьшем из значений привязки.

  • Для вычисления круговой статистики отметьте параметр Вычислить круговую статистику (circular_calculation = "CIRCULAR" в Python) и укажите для параметра Значение обхвата окружности (circular_wrap_value в Python).

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

  • Тип выходных данных (целочисленный или с плавающей точкой) зависит от выполняемого зонального вычисления и типа данных входного растра значений. Обратитесь к статье Как работает инструмент Зональная статистика за информацией по конкретным характеристикам статистических показателей.

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

    Чтобы инструмент использовал меньшее число ядер, измените параметр среды Коэффициент параллельной обработки.

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

Параметры

ПодписьОписаниеТип данных
Входные растровые или векторные данные зон

Набор данных, который определяет зоны.

Зоны могут быть определены слоем целочисленного растра или векторным слоем.

Raster Layer; Feature Layer
Поле зоны

Поле, которое содержит значения, определяющие каждую зону.

Это может быть целочисленное или строковое поле набора данных зоны.

Field
Входной растр значений

Растр, содержащий значения, по которым будет рассчитываться статистика.

Raster Layer
Тип статистики
(Дополнительный)

Задает вычисляемый тип статистики.

  • СреднееВычисляется среднее из значений всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.Используется по умолчанию.
  • БольшинствоОпределяется значение, наиболее часто встречающееся в значениях всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • Число большинстваВычисляется частота всех ячеек, содержащих значение большинства в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • Процент большинстваВычисляется процент ячеек, содержащих значение большинства в растре значений, принадлежащих той же зоне, что и выходная ячейка.
  • МаксимумВычисляется наибольшее значение из всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • МедианаВычисляется значение медианы для значений всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • МинимумВычисляется наименьшее значение из всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • МеньшинствоВычисляется значение, наименее часто встречающееся в значениях всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • Число меньшинстваВычисляется частота всех ячеек, содержащих значение меньшинства в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • Процент меньшинстваВычисляется процент ячеек, содержащих значение меньшинства в растре значений, принадлежащих той же зоне, что и выходная ячейка.
  • ПроцентильВычисляет процентиль всех ячеек в растре значений, которые принадлежат той же зоне, что выходная ячейка. Девяностый процентиль вычисляется по умолчанию. Вы можете задать другие значения (от 1 до 100) с помощью параметра Значение процентиля.
  • ДиапазонВычисляется разница между наименьшим и наибольшим значениями всех ячеек растра, которые принадлежат той же зоне, что и выходная ячейка.
  • Среднеквадратическое отклонениеВычисляется Среднеквадратическое отклонение всех ячеек растра значений, которые принадлежат той же зоне, что выходная ячейка.
  • СуммаВычисляется общее значение всех ячеек растра значений, которые принадлежат той же зоне, что выходная ячейка.
  • РазнообразиеВычисляется количество уникальных значений для всех ячеек во входном растре значений, которые принадлежат к той же зоне, что и выходная ячейка.
String
Игнорировать значение NoData при вычислениях
(Дополнительный)

Определяет, будут ли значения NoData во входном значении игнорироваться в результатах для зоны, в которую они попадают.

  • Отмечено - в любой зоне только ячейки, имеющие значение во входном растре значений, будут использованы при определении выходного значения для этой зоны. Ячейки NoData в растре значений будут игнорироваться в вычислении статистики. Используется по умолчанию.
  • Не отмечено - в любой конкретной зоне, если ячейки NoData существуют в растре значений, они не будут игнорироваться, и их наличие указывает на то, что информации недостаточно для выполнения статистических вычислений для всех ячеек в этой зоне. Следовательно, вся зона получит значение NoData.
Boolean
Обработать как многомерный
(Дополнительный)

Определяет, как будут вычисляться входные растры, если они являются многомерными.

  • Не отмечено - статистика будет вычисляться на основе текущего фрагмента входного многомерного набора данных. Используется по умолчанию.
  • Отмечено – статистика будет вычисляться для всех измерений входного многомерного набора данных.
Boolean
Значение процентиля
(Дополнительный)

Процентиль, который будет вычислен. Значение по умолчанию – 90, определяющее 90-й процентиль.

Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен минимуму в статистике, а 100-й - максимуму. Значение 50 даст, по существу, тот же результат, что и медиана в статистике.

Этот параметр доступен только в том случае, если для параметра Тип статистики задано Процентиль.

Double
Тип интерполяции процентиля
(Дополнительный)

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

  • Автоматическое определениеЕсли входной растр значений - целочисленный, используется метод Ближайший. Если тип пикселов входного растра - значение с плавающей точкой, используется Линейный метод. Используется по умолчанию.
  • Ближайшая окрестностьИспользуется ближайшее доступное значение к желаемому процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре значений.
  • ЛинейнаяИспользуется средневзвешенное значение двух окружающих значений из желаемого процентиля. В этом случае тип выходного пиксела - с плавающей точкой.
String
Вычислить круговую статистику
(Дополнительный)

Задает, как входной растр будет обрабатываться для круговых данных.

  • Не отмечено - вычисляется обычная линейная статистика. Используется по умолчанию.
  • Отмечено - вычисляется статистика для углов или других циклических величин, таких как направление по компасу в градусах, время дня или дробная часть действительного числа.
Boolean
Значение обхвата окружности
(Дополнительный)

Значение, которое будет использоваться для округления линейного значения до диапазона данной круговой статистики. Значение должно быть положительным целочисленным или с плавающей точкой. Значение по умолчанию 360 градусов.

Этот параметр поддерживается, только если выбран параметр Вычислить круговую статистику.

Double

Возвращаемое значение

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

Выходной растр зональной статистики.

Raster

ZonalStatistics(in_zone_data, zone_field, in_value_raster, {statistics_type}, {ignore_nodata}, {process_as_multidimensional}, {percentile_value}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value})
ИмяОписаниеТип данных
in_zone_data

Набор данных, который определяет зоны.

Зоны могут быть определены слоем целочисленного растра или векторным слоем.

Raster Layer; Feature Layer
zone_field

Поле, которое содержит значения, определяющие каждую зону.

Это может быть целочисленное или строковое поле набора данных зоны.

Field
in_value_raster

Растр, содержащий значения, по которым будет рассчитываться статистика.

Raster Layer
statistics_type
(Дополнительный)

Задает вычисляемый тип статистики.

  • MEANВычисляется среднее из значений всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.Используется по умолчанию.
  • MAJORITYОпределяется значение, наиболее часто встречающееся в значениях всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MAJORITY_COUNTВычисляется частота всех ячеек, содержащих значение большинства в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MAJORITY_PERCENTВычисляется процент ячеек, содержащих значение большинства в растре значений, принадлежащих той же зоне, что и выходная ячейка.
  • MAXIMUMВычисляется наибольшее значение из всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MEDIANВычисляется значение медианы для значений всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MINIMUMВычисляется наименьшее значение из всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MINORITYВычисляется значение, наименее часто встречающееся в значениях всех ячеек в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MINORITY_COUNTВычисляется частота всех ячеек, содержащих значение меньшинства в растре значений, которые принадлежат той же зоне, что и выходная ячейка.
  • MINORITY_PERCENTВычисляется процент ячеек, содержащих значение меньшинства в растре значений, принадлежащих той же зоне, что и выходная ячейка.
  • PERCENTILEВычисляет процентиль всех ячеек в растре значений, которые принадлежат той же зоне, что выходная ячейка. Девяностый процентиль вычисляется по умолчанию. Вы можете задать другие значения (от 1 до 100) с помощью параметра Значение процентиля.
  • RANGEВычисляется разница между наименьшим и наибольшим значениями всех ячеек растра, которые принадлежат той же зоне, что и выходная ячейка.
  • STDВычисляется Среднеквадратическое отклонение всех ячеек растра значений, которые принадлежат той же зоне, что выходная ячейка.
  • SUMВычисляется общее значение всех ячеек растра значений, которые принадлежат той же зоне, что выходная ячейка.
  • VARIETYВычисляется количество уникальных значений для всех ячеек во входном растре значений, которые принадлежат к той же зоне, что и выходная ячейка.
String
ignore_nodata
(Дополнительный)

Определяет, будут ли значения NoData во входном значении игнорироваться в результатах для зоны, в которую они попадают.

  • DATAВ любой зоне только ячейки, содержащие значение во входном растре значений, используются при определении выходного значения для этой зоны. Ячейки NoData в растре значений будут игнорироваться в вычислении статистики. Используется по умолчанию.
  • NODATAВ любой конкретной зоне, если ячейки NoData существуют в растре значений, они не будут игнорироваться, и их наличие указывает на то, что информации недостаточно для выполнения статистических вычислений для всех ячеек в этой зоне. Следовательно, вся зона получит значение NoData.
Boolean
process_as_multidimensional
(Дополнительный)

Определяет, как будут вычисляться входные растры, если они являются многомерными.

  • CURRENT_SLICEСтатистика будет вычисляться на основе текущего фрагмента входного многомерного набора данных. Используется по умолчанию.
  • ALL_SLICESСтатистика будет вычисляться для всех измерений входного многомерного набора данных.
Boolean
percentile_value
(Дополнительный)

Процентиль, который будет вычислен. Значение по умолчанию – 90, определяющее 90-й процентиль.

Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен минимуму в статистике, а 100-й - максимуму. Значение 50 даст, по существу, тот же результат, что и медиана в статистике.

Этот параметр поддерживается только в том случае, если для параметра statistics_type установлено значение PERCENTILE.

Double
percentile_interpolation_type
(Дополнительный)

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

  • AUTO_DETECTЕсли тип пикселов входного растра - целое число, используется метод NEAREST. Если тип пикселов входного растра - значение с плавающей точкой, используется метод LINEAR. Используется по умолчанию.
  • NEARESTИспользуется ближайшее доступное значение к желаемому процентилю. В этом случае выходной тип пиксела будет таким же, как и во входном растре значений.
  • LINEARИспользуется средневзвешенное значение двух окружающих значений из желаемого процентиля. В этом случае тип выходного пиксела - с плавающей точкой.
String
circular_calculation
(Дополнительный)

Задает, как входной растр будет обрабатываться для круговых данных.

  • ARITHMETICВычисляется обычная линейная статистика. Используется по умолчанию.
  • CIRCULARВычисляется статистика для углов или других циклических величин, таких как направление по компасу в градусах, время дня или дробная часть действительного числа.
Boolean
circular_wrap_value
(Дополнительный)

Значение, которое будет использоваться для округления линейного значения до диапазона данной круговой статистики. Значение должно быть положительным целочисленным или с плавающей точкой. Значение по умолчанию 360 градусов.

Этот параметр поддерживается только в том случае, если для параметра circular_calculation задано CIRCULAR.

Double

Возвращаемое значение

ИмяОписаниеТип данных
out_raster

Выходной растр зональной статистики.

Raster

Пример кода

ZonalStatistics Пример 1 (окно Python)

В этом примере для каждой зоны определяется диапазон значений ячеек во входном растре значений.

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZonalStats = ZonalStatistics("zone", "value", "valueraster", "RANGE",
                                "NODATA")
outZonalStats.save("C:/sapyexamples/output/zonestatout")
ZonalStatistics, пример 2 (автономный скрипт)

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

# Name: ZonalStatistics_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones 
#              of another dataset.
# Requirements: Spatial Analyst Extension

# Import system modules
import arcpy
from arcpy.sa import *

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"

# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf" 

# Execute ZonalStatistics
outZonalStatistics = ZonalStatistics(inZoneData, zoneField, inValueRaster,
                                     "MAXIMUM", "NODATA", "ALL_SLICES")

# Save the output 
outZonalStatistics.save("C:/sapyexamples/output/zonestatout2.crf")
ZonalStatistics Пример 1 (окно Python)

В этом примере для каждой зоны определяется диапазон значений ячеек во входном растре значений.

import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C://data"
outZonalStats = ZonalStatistics("zone", "value", "valueraster", "RANGE",
                                "NODATA")
outZonalStats.save("C:/output/zonestatout")
ZonalStatistics, пример 2 (автономный скрипт)

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

# Name: ZonalStatistics_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones 
#              of another dataset.
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy.ia import *

# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")

# Set the analysis environments
arcpy.env.workspace = "C:/sapyexamples/data"

# Set the local variables
inZoneData = "zones.shp"
zoneField = "sampleID"
inValueRaster = "multidimensional_valueraster.crf"

# Execute ZonalStatistics
outZonalStatistics = ZonalStatistics(inZoneData, zoneField, inValueRaster,
                                     "MAXIMUM", "NODATA", "ALL_SLICES")

# Save the output 
outZonalStatistics.save("C:/sapyexamples/output/zonestatout2.crf")

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