Доступно с лицензией Spatial Analyst.
Сводка
Определяет значение в списке аргументов, который находится на определенном уровне распространенности по принципу «ячейка-за-ячейкой». Конкретный уровень распространенности (количество повторов каждого значения) задается первым аргументом.
Иллюстрация
Использование
Этот инструмент оценивает встречаемость значений входных растров для каждого местоположения и ранжирует их с использованием порядковой шкалы – то есть, определяет самое распространенное значение, второе по распространенности значение, и так далее. Он выдаст значение заданного n-го наиболее распространенного значения, определяемого значением распространенности.
В списке входных растров порядок не важен. Однако растр, который определяет положение распространенности, должен предшествовать им.
В перечне входных растров может быть задано произвольное число растров.
Если для какой-либо ячейки входные значения совпадают, независимо от заданного значения распространенности, выходное значение будет равно входному для этого местоположения ячейки.
Если значение ячейки на любом из входных растров – NoData, местоположению этой ячейки на выходном растре будет также присвоено значение NoData.
Если не будет найдено единственное значение, которое является n-ым наиболее распространенным, местоположению на выходном растре будет присвоено значение NoData. Эта ситуация может возникнуть в том случае, если значения входных растров в конкретном местоположении различаются, либо когда значения двух или нескольких входных растров встречаются одинаковое количество раз, и число повторов равно значению n-го наиболее распространенного значения. Возврат одного из входных значений растров, например, первого, встреченного в процессе сканирования, будет обманчивым. Вы не будете знать, является ли значение n-ым наиболее распространенным значением в действительности.
Если значение распространенности больше числа входных растров, каждому местоположению ячейки в выходном растре будет присвоено значение NoData.
Если в качестве значения распространенности растра задан ноль, выходным значением будет значение NoData.
Уровень распространенности 1 – это наиболее часто встречающееся значение, аналогичное опции Большинство инструмента Статистика по ячейкам.
Если хотя бы один из входных растров содержит значения с плавающей точкой, выходные данные также будут содержать числа с плавающей точкой; в противном случае, выходной растр будет целочисленным.
Если параметр Обработать как многоканальный не отмечен (для process_as_multiband задано SINGLE_BAND в Python), будет использоваться только первый канал многоканального Входного растра распространенности или константы (in_popularity_raster_or_constant в Python). Каждый канал многоканального Входного растра (in_rasters в Python) будет обрабатываться отдельно - как одноканальный растр.
Если отмечен параметр Обработать как многоканальный (для process_as_multiband задано MULTI_BAND в Python), каждый многоканальный входной растр будет обрабатываться, как многоканальный растр.
Число каналов выходного растра зависит от Входного растра растр распространенности или константы. Если Входной растр распространенности одноканальный, число каналов выходного растра будет соответствовать максимальному числу каналов из всех входных многоканальных растров. Если растр распространенности многоканальный, выходной растр будет содержать такое же число каналов, как и этот растр распространенности.
Если любой из Входных растров является растром с числом каналов, меньшим, чем содержится в выходном растре, отсутствующие каналы будут интерпретироваться, как каналы, заполненные значениями NoData. Если значение ячейки растра распространенности берет значение отсутствующего канала, выходной растр получит значение NoData. Если любой из входных растров - константа, это будет интерпретироваться как многоканальный растр, все значения во всех каналах которого будут равны этому значению, а число каналов будет соответствовать числу каналов выходного растра.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Popularity(in_popularity_raster_or_constant, in_rasters, {process_as_multiband})| Parameter | Объяснение | Тип данных |
in_popularity_raster_or_constant | Входной растр, определяющий возвращаемое положение распространенности. В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды. | Raster Layer; Constant |
in_rasters [in_raster,...] | Перечень входных растров, используемых для оценки распространенности значений для каждого местоположения ячейки. | Raster Layer |
process_as_multiband (Дополнительный) | Задает способ обработки каналов входного многоканального растра.
| Boolean |
Значение отраженного сигнала
| Name | Объяснение | Тип данных |
| out_raster | Выходной растр. Каждая ячейка выходного растра представляет значение из того же местоположения входных растров, которое соответствует входному значению распространенности. | Raster |
Пример кода
В этом примере выполняется операция распространённости на нескольких входных растрах, в результате чего получается растр IMG.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPopularity = Popularity("cost", ["degs", "negs", "fourgrd"])
outPopularity.save("C:/sapyexamples/output/outpop.img")В этом примере выполняется операция распространённости на нескольких входных растрах, в результате чего получается растр грида.
# Name: Popularity_Ex_02.py
# Description: Determines the value in an argument list that is
# at a certain level of popularity
# Requirements: Spatial Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.sa import *
# Set environment settings
env.workspace = "C:/sapyexamples/data"
# Set local variables
inPopularityRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"
# Execute Popularity
outPopularity = Popularity(inPopularityRaster, [inRaster01, inRaster02, inRaster03])
# Save the output
outPopularity.save("C:/sapyexamples/output/outpop")Environments
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst