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

Сводка

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

Иллюстрация

Иллюстрация инструмента Зональная статистика в таблицу

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

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

  • Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise Ссылка на разбор анализа в ArcGIS Enterprise портал с расширением ArcGIS Image Server Ссылка на раздел Что такое ArcGIS Image Server настроенный для Raster Analysis Ссылка на настройку и развертывание аналитики растров. При вызове инструмента сервера ArcGIS Pro являются клиентами, и обработка будет выполнятся на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.

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

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

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

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

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

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

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

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

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

  • Входной растр значений может быть либо целочисленным, либо может быть представлен значениями с плавающей точкой. Но если тип данных – числа с плавающей точкой, опции для вычисления большинства, медианы, меньшинства и разнообразия будут недоступны. Для вычислений большинства и меньшинства, если есть привязка, выходные данные для зоны основаны на наименьшем из значений привязки.

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

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

Синтаксис

ZonalStatisticsAsTable(inputZoneRasterOrFeatures, inputValueRaster, outputTableName, zoneField, {ignoreNodata}, {statisticType}, {percentileValues}, {processAsMultidimensional})
ParameterОбъяснениеТип данных
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 даст по существу тот же результат, что и Медиана в статистике.

Эта опция доступна, только если для параметра statisticType задано значение PERCENTILE или ALL.

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

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

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

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

NameОбъяснениеТип данных
outputTable

Выходная таблица.

Сервис объектов без геометрии

Пример кода

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

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

import arcpy
arcpy.ZonalStatisticsasTable_ra('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 = 'ALL'
percentileValues = [25,75,90]
processAsMultidimensional = 'ALL_SLICES'

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

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

  • Basic: Требуется ArcGIS Image Server
  • Standard: Требуется ArcGIS Image Server
  • Advanced: Требуется ArcGIS Image Server

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