Сводка
Вычисляет статистику по значениям растра в пределах зон, определяемых другим набором данных.
Иллюстрация
Использование
Зона определяется как все области входных данных, имеющие одно значение. Области не обязательно должны быть непрерывными. И растры, и векторные объекты могут использоваться для входных данных зон.
Этот инструмент портала для анализа растров доступен, если вы выполнили вход в ArcGIS Enterprise
портал с расширением ArcGIS Image Server настроенный для Raster Analysis . При вызове инструмента сервера ArcGIS Pro являются клиентами, и обработка будет выполнятся на серверах, интегрированных с ArcGIS Enterprise. Инструмент портала использует слои портала в качестве входных данных и создает выходные данные на этом же портале.Параметр Входной растровый слой поддерживает следующие элементы: слой портала, URI или URL сервиса изображений, выходные данные инструмента Создать слой сервера изображений. Сходной векторный слой может быть слоем портала. Это может быть URI или URL сервиса объектов. Указанный инструмент не поддерживает локальные наборы растровых данных или слои. Хотя вы можете использовать локальные векторные данные или слои как входные данные для инструментов портала, лучше все же использовать слои портала в качестве входных данных.
Если Входной слой зон (inputZoneLayer в Python) представлен растром, он должен быть целочисленный.
Если входные данные зон представлены пространственными объектами, они будет конвертированы в растр, при этом размер ячейки и выравнивание считываются из Входного растра.
Если Размер ячейки во Входном слое зон (inputZoneLayer в Python) и во Входном растровом слое суммирования (inputRasterLayertoSummarize в Python) различается, то размер выходной ячейки будет Максимальный из входных, а растр значений будет использоваться как Растр привязки при внутренней конвертации. Если размер ячейки совпадает, но ячейки не выровнены, то растр значений будет использован как растр привязки при внутренней конвертации. В любом из этих случаев перед выполнением зональной операции будет инициирован внутренний пересчет.
Если входные данные зон и значений являются растрами с одинаковым размером ячеек, и с корректным выравниванием, они будут использоваться непосредственно в инструменте и не будут пересчитаны во время выполнения инструмента.
Если какая-либо зона в Входном слое зон не перекрывает ни один центр ячейки входного растра значений, эта зона будет определена как NoData. В этом случае определите соответствующее разрешение растра, которое будет отображать все детали входных объектов зон, и используйте это разрешение как Размер ячейки в параметрах среды. Если вы укажите меньший размер ячейки, выходной растр будет большего размера. Более высокий уровень разрешения выходных данных не даст вам возможности получить выходные данные более высокого качества, так как подробная детализация все равно отсутствует во Входном растровом слое для суммирования.
Если Входной слой зон имеют перекрывающиеся полигоны, зональный анализ не будет выполняться для каждого индивидуального полигона. Поскольку векторные входные данные конвертируются в растр, каждое местоположение может иметь только одно значение.
Альтернативный метод заключается в обработке зональных данных итеративно для каждой из полигональных зон с последующим сопоставлением результатов.
Если Входной слой зон представлен набором точечных данных, возможно, что в каждую конкретную ячейку входного растра значений попадет больше одной точки. Для таких ячеек значение зоны определяется точкой с наименьшим ObjectID (например, OID или FID).
При указании Входного слоя зон, полем зоны по умолчанию будет первое доступное и допустимое целочисленное или текстовое поле. Если других допустимых полей нет, по умолчанию используется поле ObjectID (например, OID или FID).
Входной растровый слой для суммирования может быть целочисленным или с плавающей точкой. Но если тип данных – числа с плавающей точкой, опции для вычисления большинства, медианы, меньшинства и разнообразия будут не доступны. Для вычислений статистики большинства и меньшинства, если есть привязка, выходные данные для зоны основаны на наименьшем из значений привязки.
Поддерживаемые многомерные типы наборов данных включают многомерные сервисы изображений.
Синтаксис
SummarizeRasterWithin(inputZoneLayer, zoneField, inputRasterLayertoSummarize, outputName, {statisticType}, {ignoreMissingValues}, {processAsMultidimensional}, {percentileValue})| Parameter | Объяснение | Тип данных |
inputZoneLayer | Входной набор данных, определяющий зоны. Наборы растровых данных и наборы классов объектов могут использоваться для входных данных зон. | Raster Layer; Feature Layer |
zoneField | Поле, определяющее каждую зону. Это может быть целочисленное или строковое поле набора данных зоны. | String |
inputRasterLayertoSummarize | Растр, содержащий значения, на основании которых будет вычислена статистика. | Raster Layer |
outputName | Имя выходного слоя растрового сервиса. Если имя сервиса изображений уже используется, появится запрос ввести новое имя. | String |
statisticType (Дополнительный) | Указывает тип вычисляемой статистики. Доступные опции, если растр для суммирования является целочисленным: Среднее, Большинство, Максимум, Медиана, Минимум, Меньшинство, Процентиль, Диапазон, Средне-квадратичное отклонение, Сумма и Разнообразие. Если растр для суммирования представлен типом данных плавающей точкой, доступные опции: Среднее, Максимум, Минимум, Диапазон, Средне-квадратичное отклонение и Сумма.
| String |
ignoreMissingValues (Дополнительный) | Указывает, будут ли пропущенные значения входного растрового слоя для суммирования игнорированы для зоны результирующего слоя, в которую они попадают.
| Boolean |
processAsMultidimensional (Дополнительный) | Определяет, как будет обрабатываться входные растры, если они являются многомерными.
| Boolean |
percentileValue (Дополнительный) | Вычисляемый процентиль. Значение по умолчанию – 90, для 90-го процентиля. Значения могут варьироваться от 0 до 100. 0-й процентиль по существу эквивалентен Минимума в статистике, а 100-й процентиль эквивалентен Максимуму. Значение 50 даст по существу тот же результат, что и Медиана в статистике. Эта опция доступна, только если для параметра statisticType задано значение PERCENTILE. | Double |
Производные выходные данные
| Name | Объяснение | Тип данных |
| outputRaster | Выходной растр. | Растровый слой |
Пример кода
В этом примере для каждой зоны определяется среднее арифметическое значение ячеек в слое растра для суммирования.
import arcpy
arcpy.SummarizeRasterWithin_ra('https://MyPortal.esri.com/server/rest/services/Hosted/landuse/ImageServer',
'Landuse', 'https://MyPortal.esri.com/server/rest/services/Hosted/elevation/ImageServer',
'outRaster', 'MEAN', 'DATA')В этом примере для каждой зоны определяется среднее значение ячеек в слое растра для суммирования.
#-------------------------------------------------------------------------------
# Name: SummarizeRasterWithin_Ex_02.py
# Description: Calculates the maximum sea-surface temperature at different ecological zones.
# Requirements: ArcGIS Image Server
# Import system modules
import arcpy
# Set local variables
inputZoneLayer = 'https://MyPortal.esri.com/server/rest/services/Hosted/zones/ImageServer'
zoneField = 'temperature'
inputRasterLayertoSummarize = 'https://MyPortal.esri.com/server/rest/services/Hosted/seaSurfaceTemperature/ImageServer'
outputName = 'outSSTRaster'
statisticType = 'MAXIMUM'
ignoreMissingValues = ''
processAsMultidimensional = 'ALL_SLICES'
# Execute Multidimensional Summarize Raster Within operation
arcpy.SummarizeRasterWithin_ra(inputZoneLayer, zoneField, inputRasterLayertoSummarize,
outputName, statisticType, ignoreMissingValues)Environments
Информация о лицензиях
- Basic: Требуется ArcGIS Image Server
- Standard: Требуется ArcGIS Image Server
- Advanced: Требуется ArcGIS Image Server