Доступно с лицензией Spatial Analyst.
Краткая информация
Определяет значение в списке аргументов, который находится на определенном уровне распространенности по принципу «ячейка-за-ячейкой». Конкретный уровень распространенности (количество повторов каждого значения) задается первым аргументом.
Иллюстрация
Использование
Этот инструмент оценивает встречаемость значений входных растров для каждого местоположения и ранжирует их с использованием порядковой шкалы – то есть, определяет самое распространенное значение, второе по распространенности значение, и так далее. Он выдаст значение заданного n-го наиболее распространенного значения, определяемого значением распространенности.
В списке входных растров порядок не важен. Однако растр, который определяет положение распространенности, должен предшествовать им.
В перечне входных растров может быть задано произвольное число растров.
Если для какой-либо ячейки входные значения совпадают, независимо от заданного значения распространенности, выходное значение будет равно входному для этого местоположения ячейки.
Если для параметра Входной растр распространения или константа (in_popularity_raster_or_constant в Python) указан многоканальный растр, будет использован только первый канал. Чтобы обработать другой канал, укажите его.
Если многоканальный растр указан как один из входных для параметра Входные растры (in_rasters в Python), будут обработаны все каналы.
Чтобы обработать выбранные каналы многоканального растра, сначала создайте новый набор растровых данных, состоящий только из необходимых каналов, с помощью инструмента Объединить каналы, затем укажите полученный набор как Входной растр (in_rasters в Python).
Если значение ячейки на любом из входных растров – NoData, местоположению этой ячейки на выходном растре будет также присвоено значение NoData.
Если не будет найдено единственное значение, которое является n-ым наиболее распространенным, местоположению на выходном растре будет присвоено значение NoData. Эта ситуация может возникнуть в том случае, если значения входных растров в конкретном местоположении различаются, либо когда значения двух или нескольких входных растров встречаются одинаковое количество раз, и число повторов равно значению n-го наиболее распространенного значения. Возврат одного из входных значений растров, например, первого, встреченного в процессе сканирования, будет обманчивым. Вы не будете знать, является ли значение n-ым наиболее распространенным значением в действительности.
Если значение распространенности больше числа входных растров, каждому местоположению ячейки на выходном растре будет присвоено значение NoData.
Если в качестве значения распространенности растра задан ноль, выходным значением будет значение NoData.
Уровень распространенности 1 – это наиболее часто встречающееся значение, аналогичное опции Большинство инструмента Статистика по ячейкам.
Если хотя бы один из входных растров содержит значения с плавающей точкой, выходные данные также будут содержать числа с плавающей точкой; в противном случае, выходной растр будет целочисленным.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
Popularity(in_popularity_raster_or_constant, in_rasters)
| Параметр | Объяснение | Тип данных |
in_popularity_raster_or_constant | Входной растр, определяющий выдаваемое положение распространенности. В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды. | Raster Layer; Constant |
in_rasters [in_raster,...] | Перечень входных растров, используемых для оценки распространенности значений для каждого местоположения ячейки. | Raster Layer |
Возвращаемое значение
| Имя | Объяснение | Тип данных |
| out_raster | Выходной растр. Каждая ячейка выходного растра представляет значение из того же местоположения входных растров, которое соответствует входному значению распространенности. | Raster |
Пример кода
Popularity, пример 1 (окно Python)
В этом примере выполняется операция распространённости на нескольких входных растрах, в результате чего получается растр 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")
Popularity, пример 2 (автономный скрипт)
В этом примере выполняется операция распространённости на нескольких входных растрах, в результате чего получается растр грида.
# 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"
# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")
# Execute Popularity
outPopularity = Popularity(inPopularityRaster, [inRaster01, inRaster02, inRaster03])
# Save the output
outPopularity.save("C:/sapyexamples/output/outpop")
Параметры среды
Информация о лицензиях
- Basic: Требуется Spatial Analyst
- Standard: Требуется Spatial Analyst
- Advanced: Требуется Spatial Analyst