Зональная статистика в таблицу (Анализ растра)

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

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

Иллюстрация

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

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

• Этот инструмент портала для анализа растров доступен, когда вы выполнили вход на портал ArcGIS Enterprise с настроенным модулем ArcGIS Image Server для Анализ растров. Когда инструмент запускается, ArcGIS Pro выступает в качестве клиента, и обработка проходит на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.

  Параметр Входной растровый слой поддерживает слой портала, URI или URL сервиса изображений или выходные данные инструмента Создать слой сервера изображений. Входной векторный слой может быть слоем портала или URI либо URL сервиса объектов. Указанный инструмент не поддерживает локальные наборы растровых данных или слои. Хотя вы можете использовать локальные векторные данные или слои как входные данные для инструментов портала, лучше все же использовать слои портала в качестве входных данных.

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

  Если входные данные зон представлены пространственными объектами, они будет конвертированы в растр, при этом размер ячейки и выравнивание считываются из Входного растра (inputValueRaster Python).

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

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

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

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

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

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

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

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

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

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

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

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

  Имя поля такое же, как и в Типе статистики для арифметических вычислений. Это значение по умолчанию

  Тем не менее для циклической статистики, для имени поля предусмотрен префикс C_, за которым следует указанная статистика. Например, имя поля будет Median для арифметической медианы и C_Median для циклической медианы.

Параметры

Диалог

Подпись	Описание	Тип данных
Входной растр зоны или объектов	Входной набор данных, определяющий зоны. Наборы растровых данных и наборы классов объектов могут использоваться для входных данных зон.	Raster Layer; Feature Layer
Входной растр значений	Растр, содержащий значения, на основании которых будет вычислена статистика.	Raster Layer
Имя выходной таблицы	Имя выходной таблицы. Если таблица с таким именем уже существует, появится запрос ввести новое имя.	String
Поле зоны	Поле, определяющее каждую зону. Это может быть целочисленное или строковое поле набора данных зоны.	String
Игнорировать значение NoData при вычислениях (Дополнительный)	Определяет, будут ли значения NoData входного набора данных значений влиять на результаты зоны, в которую они попадают. Отмечено – в любой зоне только ячейки, имеющие значение во входном растре значений, будут использованы при определении выходного значения для этой зоны. При определении статистики будут использованы только ячейки из окрестности обрабатываемой ячейки, имеющие значения. Это значение по умолчанию Не отмечено - если в пределах конкретной зоны в растре значений присутствуют ячейки NoData, ячейка не игнорируется и наличие такой ячейки указывает на отсутствие необходимой информации для вычисления статистики для всех ячеек этой зоны. Соответственно, все ячейки зоны получат значения NoData в выходном растра.	Boolean
Тип статистики (Дополнительный)	Указывает тип вычисляемой статистики. Доступные параметры, когда растр значения является целочисленным, таковы: Все, Среднее, Majority, Большинство, Медиана, Минимум, Меньшинство, Процентиль, Диапазон, Среднеквадратическое отклонение, Сумма, Разнообразие, Минимум и максимум, Среднее и Среднеквадратическое отклонение, and Минимум, максимум и среднее. Если значение растра является числом с плавающей точкой, доступные опции Все, Среднее, Максимум, Медиана, Процентиль, Минимум, Диапазон, Среднеквадратическое отклонение и Сумма. Все—Вся статистика будет вычисляться для целочисленных значений растров. Для растра значений с плавающей точкой будет вычисляться вся статистика, кроме Медиана и Процентиль. Это значение по умолчанию Среднее—Будет рассчитано значение Среднее для всех ячеек в растровом слое, подлежащих суммированию, которые принадлежат той же зоне, что и выходная ячейка. Большинство—Вычисляется значение, чаще всего встречаемое среди всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Максимум—Вычисляется максимальное значение из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Медиана—Вычисляется медиана значений всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Минимум—Вычисляется минимальное значение из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Меньшинство—Вычисляется значение, реже всего встречаемое среди всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Процентиль—Будет рассчитано значение процентиля для всех ячеек на растре значений, которые принадлежат той же зоне, что и выходная ячейка. Девяностый процентиль вычисляется по умолчанию. Вы можете указать другие значения (от 0 до 100), используя параметр Значения процентиля. Диапазон—Вычисляется разность между максимальным и минимальным значением из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Среднеквадратическое отклонение—Вычисляется средне-квадратичное отклонение для всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Сумма—Вычисляется суммарное значение всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Разнообразие—Вычисляется число уникальных значений из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. Минимум и максимум—Будет вычисляться статистика Минимум и Максимум. Среднее и Среднеквадратическое отклонение—Будет вычисляться статистика Среднее и Среднеквадратическое отклонение. Минимум, Максимум и Среднее—Будет вычисляться статистика Минимум, Максимум и Среднее.	String
Значения процентиля (Дополнительный)	Процентиль, который будет вычислен. Значение по умолчанию – 90, для 90-го процентиля. Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимума в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике. Этот параметр доступен только при расчете процентиля.	Double
Обработать как многомерный (Дополнительный)	Определяет, как будет обрабатываться входные растры, если они являются многомерными. Не отмечено – статистика будет вычисляться из текущего среза входного многомерного набора данных. Это значение по умолчанию Отмечено – статистика будет вычисляться для всех измерений (таких как время или глубина) всех срезов многомерного входного растра.	Boolean
Тип интерполяции Процентиль (Дополнительный)	Определяет метод интерполяции, который будет использоваться, когда значение процентиля находится между двумя значениями ячеек из растра входных значений. Автоопределение—Если входной растр значений содержит целочисленные пикселы, бут использоваться метод Ближайший. Если входной растр значений содержит пикселы с плавающей точкой, используется метод Линейная. Это значение по умолчанию Ближайший—Будет использоваться ближайшее доступное значение к заданному процентилю. Линейный—Будет использоваться взвешенное среднее от двух соседних значений от заданного процентиля.	String
Вычислить круговую статистику (Дополнительный)	Указывает, как будет вычислен тип статистики. Не отмечено — Будет вычислена арифметическая статистика. Это значение по умолчанию Отмечено — будет вычислена круговая статистика, подходящая для циклических величин, таких как компасное направление в градусах, время дня и дробная часть вещественного числа.	Boolean
Значение охвата окружности (Дополнительный)	Максимально возможное значение (верхняя граница) в циклических данных. Это положительное число, значение по умолчанию равно 360. Это значение также представляет ту же величину, что и минимально возможное значение (нижняя граница). Этот параметр применим только при вычислении круговой статистики.	Double

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

Подпись	Описание	Тип данных
Выходная таблица	Выходная таблица.	Feature service without geometry

Python

arcpy.ra.ZonalStatisticsAsTable(inputZoneRasterOrFeatures, inputValueRaster, outputTableName, zoneField, {ignoreNodata}, {statisticType}, {percentileValues}, {processAsMultidimensional}, {percentileInterpolationType}, {circularCalculation}, {circularWrapValue})

Имя	Описание	Тип данных
inputZoneRasterOrFeatures	Входной набор данных, определяющий зоны. Наборы растровых данных и наборы классов объектов могут использоваться для входных данных зон.	Raster Layer; Feature Layer
inputValueRaster	Растр, содержащий значения, на основании которых будет вычислена статистика.	Raster Layer
outputTableName	Имя выходной таблицы. Если таблица с таким именем уже существует, появится запрос ввести новое имя.	String
zoneField	Поле, определяющее каждую зону. Это может быть целочисленное или строковое поле набора данных зоны.	String
ignoreNodata (Дополнительный)	Определяет, будут ли значения NoData входного набора данных значений влиять на результаты зоны, в которую они попадают. DATA—В любой зоне только ячейки, содержащие значение во входном растре значений, используются при определении выходного значения для этой зоны. При определении статистики будут использованы только ячейки из окрестности обрабатываемой ячейки, имеющие значения. Это значение по умолчанию NODATA—Если в пределах конкретной зоны в растре значений присутствуют ячейки NoData, ячейка не игнорируется и наличие такой ячейки указывает на отсутствие необходимой информации для вычисления статистики для всех ячеек этой зоны. Соответственно, все ячейки зоны получат значения NoData в выходном растра.	Boolean
statisticType (Дополнительный)	Указывает тип вычисляемой статистики. Доступные параметры, когда растр значения является целочисленным, таковы: Все, Среднее, Majority, Большинство, Медиана, Минимум, Меньшинство, Процентиль, Диапазон, Среднеквадратическое отклонение, Сумма, Разнообразие, Минимум и максимум, Среднее и Среднеквадратическое отклонение, and Минимум, максимум и среднее. Если значение растра является числом с плавающей точкой, доступные опции Все, Среднее, Максимум, Медиана, Процентиль, Минимум, Диапазон, Среднеквадратическое отклонение и Сумма. ALL—Вся статистика будет вычисляться для целочисленных значений растров. Для растра значений с плавающей точкой будет вычисляться вся статистика, кроме Медиана и Процентиль. Это значение по умолчанию MEAN—Будет рассчитано значение Среднее для всех ячеек в растровом слое, подлежащих суммированию, которые принадлежат той же зоне, что и выходная ячейка. MAJORITY—Вычисляется значение, чаще всего встречаемое среди всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. MAXIMUM—Вычисляется максимальное значение из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. MEDIAN—Вычисляется медиана значений всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. MINIMUM—Вычисляется минимальное значение из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. MINORITY—Вычисляется значение, реже всего встречаемое среди всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. PERCENTILE—Будет рассчитано значение процентиля для всех ячеек на растре значений, которые принадлежат той же зоне, что и выходная ячейка. Девяностый процентиль вычисляется по умолчанию. Вы можете указать другие значения (от 0 до 100), используя параметр Значения процентиля. RANGE—Вычисляется разность между максимальным и минимальным значением из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. STD—Вычисляется средне-квадратичное отклонение для всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. SUM—Вычисляется суммарное значение всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. VARIETY—Вычисляется число уникальных значений из всех ячеек растрового слоя для суммирования, которые принадлежат той же зоне, что и выходная ячейка. MIN_MAX—Будет вычисляться статистика Минимум и Максимум. MEAN_STD—Будет вычисляться статистика Среднее и Среднеквадратическое отклонение. MIN_MAX_MEAN—Будет вычисляться статистика Минимум, Максимум и Среднее.	String
percentileValues [percentileValues,...] (Дополнительный)	Процентиль, который будет вычислен. Значение по умолчанию – 90, для 90-го процентиля. Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимума в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике. Этот параметр доступен только при расчете процентиля.	Double
processAsMultidimensional (Дополнительный)	Определяет, как будет обрабатываться входные растры, если они являются многомерными. CURRENT_SLICE—Статистика будет вычисляться из текущего среза входного многомерного набора данных. Это значение по умолчанию ALL_SLICES—Статистика будет вычисляться для всех измерений (таких как время или глубина) многомерного набора данных.	Boolean
percentileInterpolationType (Дополнительный)	Определяет метод интерполяции, который будет использоваться, когда значение процентиля находится между двумя значениями ячеек из растра входных значений. AUTO_DETECT—Если входной растр значений имеет целочисленный тип пиксела, будет использоваться метод NEAREST. Если тип пикселов входного растра - значение с плавающей точкой, будет использован метод LINEAR. Это значение по умолчанию NEAREST—Будет использоваться ближайшее доступное значение к заданному процентилю. LINEAR—Будет использоваться взвешенное среднее от двух соседних значений от заданного процентиля.	String
circularCalculation (Дополнительный)	Указывает, как будет вычислен тип статистики. ARITHMETIC—Будет вычислена арифметическая статистика. Это значение по умолчанию CIRCULAR—Будет вычислена круговая статистика, подходящая для циклических величин, таких как компасное направление в градусах, время дня и дробная часть вещественного числа.	Boolean
circularWrapValue (Дополнительный)	Максимально возможное значение (верхняя граница) в циклических данных. Это положительное число, значение по умолчанию равно 360. Это значение также представляет ту же величину, что и минимально возможное значение (нижняя граница). Этот параметр применим только при вычислении круговой статистики.	Double

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

Имя	Описание	Тип данных
outputTable	Выходная таблица.	Feature service without geometry

Пример кода

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

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

import arcpy
arcpy.ra.ZonalStatisticsAsTable('https://MyPortal.esri.com/server/rest/services/Hosted/landuse/ImageServer',
                           	'https://MyPortal.esri.com/server/rest/services/Hosted/elevation/ImageServer',
    				'outTable', 'Landuse', '', 'MEAN')

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

Этот пример определяет для каждой зоны значения статистики в растровом слое, подлежащие суммированию.

#-------------------------------------------------------------------------------
# Name: ZonalStatisticsAsTable_Ex_02.py
# Description: Calculates all statistics with defined percentile values  
#              for sea-surface temperature defined by ecological zones.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputZoneRasterOrFeatures = 'https://MyPortal.esri.com/server/rest/services/Hosted/zones/ImageServer'
inputValueRaster = 'https://MyPortal.esri.com/server/rest/services/Hosted/seaSurfaceTemperature/ImageServer'
outputTableName = 'outZSAT'
zoneField = 'temperature'
ignoreNodata = '' 
statisticType = 'PERCENTILE'
percentileValues = [25,75,90]
processAsMultidimensional = 'ALL_SLICES'
percentileInterpolationType = 'NEAREST'

# Execute Multidimensional Zonal Statistics as Table
arcpy.ra.ZonalStatisticsAsTable(inputZoneRasterOrFeatures, inputValueRaster, outputTableName, zoneField,
                                ignoreNodata, statisticType, percentileValues, processAsMultidimensional, 
                                percentileInterpolationType)

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

Размер ячейки, Экстент, Маска, Выходная система координат, Растр привязки

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

• Basic: Обязательно ArcGIS Image Server
• Standard: Обязательно ArcGIS Image Server
• Advanced: Обязательно ArcGIS Image Server