| Подпись | Описание | Тип данных |
Входные растровые или векторные данные зон | Набор данных, который определяет зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем. | Raster Layer; Feature Layer |
Поле зоны | Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны. | Field |
Входной растр значений | Растр, содержащий значения, по которым будет рассчитываться статистика. | Raster Layer |
Выходная таблица | Выходная таблица, которая содержит итоговую информацию по значениям в каждой зоне. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию на выходе будет таблица базы геоданных, если она находится в рабочей области базы геоданных, и таблица dBASE, если она находится в файловой рабочей области. | Table |
Игнорировать значение NoData при вычислениях (Дополнительный) | Определяет, будут ли значения NoData во входном значении игнорироваться в результатах для зоны, в которую они попадают.
| Boolean |
Тип статистики (Дополнительный) | Указывает тип вычисляемой статистики.
| String |
Обработать как многомерный (Дополнительный) | Определяет, как будут вычисляться входные растры, если они являются многомерными.
| Boolean |
Значения процентиля (Дополнительный) | Процентиль, который будет вычислен. Значение по умолчанию – 90, определяющее 90-й процентиль. Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен минимуму в статистике, а 100-й - максимуму. Значение 50 даст, по существу, тот же результат, что и медиана в статистике. Эта опция доступна, только если для параметра Тип статистики задано Процентиль или Все. | Double |
Тип интерполяции Процентиль (Дополнительный) | Определяет метод интерполяции, который будет использоваться, когда значение процентиля находится между двумя значениями ячеек из растра входных значений.
| String |
Вычислить круговую статистику (Дополнительный) | Задает, как входной растр будет обрабатываться для круговых данных.
| Boolean |
Значение обхвата окружности (Дополнительный) | Значение, которое будет использоваться для округления линейного значения до диапазона данной круговой статистики. Значение должно быть положительным целочисленным или с плавающей точкой. Значение по умолчанию 360 градусов. Этот параметр поддерживается, только если выбран параметр Вычислить круговую статистику. | Double |
Выходной присоединяемый слой (Дополнительный) | Выходной слой, который будет создан путем объединения выходной таблицы с данными входной зоны. | Raster Layer; Feature Layer |
Доступно с лицензией Spatial Analyst.
Доступно с лицензией Image Analyst.
Краткая информация
Суммирует значения растра в пределах зон другого набора данных и записывает результаты в таблицу.
Иллюстрация
Использование
Зона определяется как все области входных данных, имеющие одно значение. Области не обязательно должны быть непрерывными. Для входных данных зон могут использоваться и растры и объекты.
Если Входные растровые или векторные данные зоны (in_zone_data в Python) являются растром, это должен быть целочисленный растр.
Если Входные растровые или векторные данные зоны векторные, они будут конвертированы в растр с использованием размера ячейки и выравнивания ячеек из параметра Входной растр значений (in_value_raster в Python).
Если размер или выравнивание ячеек в параметрах Входные растровые или векторные данные зон и Входной растр значений различаются, внутренне будет использоваться значение Входного растр значений для получения размера ячейки и растра замыкания. В обоих случаях перед выполнением операции зонирования будет вызвано внутреннее вычисление пикселов.
Если у входного растра значений и растра зон одинаковый размер ячейки и ячейки выровнены, они будут использованы напрямую в инструменте - без пересчета значений во время работы инструмента.
Если Входные растровые или векторные данные зон являются объектами, все объекты зон, которые не пересекаются с центрами ячеек растра значений, не будут конвертироваться во внутренний растр зон. В результате, эти зоны не будут представлены в выходных данных. Вы можете управлять этим поведением, задав соответствующее значение для параметра среды размер ячеек:, что позволит сохранить желательный уровень детализации зон объектов, и задать его в параметрах среды анализа.
Если Входные растровые или векторные данные зоны представлены точечными объектами, в каждой конкретной ячейке входного растра значений может быть больше одной точки. Для таких ячеек значение зоны определяется точкой с наименьшим значением ObjectID (например, OID или FID).
Если Входные растровые или векторные данные зон содержат перекрывающиеся объекты, зональный анализ будет выполняться для каждого отдельного объекта.
При задании значения Входные растровые или векторные данные зон по умолчанию первое доступное целочисленное или текстовое поле выбирается полем зоны. Если других допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).
Поддерживаемые типы статистики зависят от типа данных в значении Входной растр значений и типа вычисляемой статистики, заданного в параметре Вычислить круговую статистику.
Если тип данных относится к целочисленным, то для вычисления арифметической статистики поддерживаются следующие варианты: Среднее, Большинство, Число большинства, Процент большинства, Максимум, Медиана, Минимум, Меньшинство, Число меньшинства, Процент меньшинства, Процентиль, Диапазон, Среднеквадратическое отклонение, Сумма и Разнообразие. Для вычисления круговой статистики поддерживаются такие варианты, как Среднее, Большинство, Меньшинство, Среднеквадратическое отклонение и Разнообразие.
Если данные с плавающей точкой, вычисление арифметической статистики поддерживает следующие варианты: Среднее, Максимум, Медиана, Минимум, Процентиль, Диапазон, Среднеквадратическое отклонение и Сумма. Вычисление круговой статистики поддерживает опции Среднее и Среднеквадратическое отклонение.
Для вычислений Большинства и Меньшинства, если есть привязка, выходные данные определяются наименьшем из значений привязки.
Для вычисления круговой статистики отметьте параметр Вычислить круговую статистику (circular_calculation = "CIRCULAR" в Python) и укажите для параметра Значение обхвата окружности (circular_wrap_value в Python).
Поддерживаемые типы наборов данных многомерных растров включают многомерный растровый слой, мозаику, сервисы изображений и Esri CRF.
В выходной таблице будет создано поле или ряд полей, в зависимости от параметра Тип статистики (statisticType в Python).
Имя поля такое же, как и в Типе статистики для арифметических вычислений. Это значение по умолчанию
Тем не менее для циклической статистики, для имени поля предусмотрен префикс C_, за которым следует указанная статистика. Например, имя поля будет Median для арифметической медианы и C_Median для циклической медианы.
Тип данных для каждого значения в полях выходной таблицы зависит от выполняемых зональных вычислений. См. Как работают инструменты Зональной статистики, чтобы узнать больше.
Число строк в выходной таблице равно числу зон.
По умолчанию этот инструмент будет использовать многоядерные процессоры, если они доступны. Максимальное число ядер, которое может быть использовано,– четыре.
Чтобы инструмент использовал меньшее число ядер, измените параметр среды Коэффициент параллельной обработки.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Параметры
ZonalStatisticsAsTable(in_zone_data, zone_field, in_value_raster, out_table, {ignore_nodata}, {statistics_type}, {process_as_multidimensional}, {percentile_values}, {percentile_interpolation_type}, {circular_calculation}, {circular_wrap_value}, {out_join_layer})| Имя | Описание | Тип данных |
in_zone_data | Набор данных, который определяет зоны. Зоны могут быть определены слоем целочисленного растра или векторным слоем. | Raster Layer; Feature Layer |
zone_field | Поле, которое содержит значения, определяющие каждую зону. Это может быть целочисленное или строковое поле набора данных зоны. | Field |
in_value_raster | Растр, содержащий значения, по которым будет рассчитываться статистика. | Raster Layer |
out_table | Выходная таблица, которая содержит итоговую информацию по значениям в каждой зоне. Формат таблицы определяется выходным местоположением и путем к ней. По умолчанию на выходе будет таблица базы геоданных, если она находится в рабочей области базы геоданных, и таблица dBASE, если она находится в файловой рабочей области. | Table |
ignore_nodata (Дополнительный) | Определяет, будут ли значения NoData во входном значении игнорироваться в результатах для зоны, в которую они попадают.
| Boolean |
statistics_type (Дополнительный) | Указывает тип вычисляемой статистики.
| String |
process_as_multidimensional (Дополнительный) | Определяет, как будут вычисляться входные растры, если они являются многомерными.
| Boolean |
percentile_values [percentile_values,...] (Дополнительный) | Процентиль, который будет вычислен. Значение по умолчанию – 90, определяющее 90-й процентиль. Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен минимуму в статистике, а 100-й - максимуму. Значение 50 даст, по существу, тот же результат, что и медиана в статистике. Этот параметр поддерживается только в том случае, если для параметра statistics_type задано PERCENTILE или ALL. | Double |
percentile_interpolation_type (Дополнительный) | Определяет метод интерполяции, который будет использоваться, когда значение процентиля находится между двумя значениями ячеек из растра входных значений.
| String |
circular_calculation (Дополнительный) | Задает, как входной растр будет обрабатываться для круговых данных.
| Boolean |
circular_wrap_value (Дополнительный) | Значение, которое будет использоваться для округления линейного значения до диапазона данной круговой статистики. Значение должно быть положительным целочисленным или с плавающей точкой. Значение по умолчанию 360 градусов. Этот параметр поддерживается только в том случае, если для параметра circular_calculation задано CIRCULAR. | Double |
out_join_layer (Дополнительный) | Выходной слой, который будет создан путем объединения выходной таблицы с данными входной зоны. | Raster Layer; Feature Layer |
Пример кода
В этом примере суммируются значения растра в зонах, определенных шейп-файлом полигона, и результаты записываются в таблицу.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outZSaT = ZonalStatisticsAsTable("zones.shp", "Classes", "valueforzone",
"zonalstattblout", "NODATA", "SUM")В этом примере суммируются значения растра в зонах, определенных шейп-файлом полигона, и результаты записываются в таблицу.
# Name: ZonalStatisticsAsTable_Ex_standalone.py
# Description: Summarizes values of a multidimensional raster within the zones
# of another dataset and reports the results to a table.
# 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"
outTable = "zonalstattblout02.dbf"
# Execute ZonalStatisticsAsTable
outZSaT = ZonalStatisticsAsTable(inZoneData, zoneField, inValueRaster,
outTable, "NODATA", "MAXIMUM", "ALL_SLICES")Параметры среды
Информация о лицензиях
- Basic: Обязательно Spatial Analyst или Image Analyst
- Standard: Обязательно Spatial Analyst или Image Analyst
- Advanced: Обязательно Spatial Analyst или Image Analyst