Популярность (Инструменты Spatial Analyst)

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

Определяет значение в списке аргументов, который находится на определенном уровне распространенности по принципу «ячейка-за-ячейкой». Конкретный уровень распространенности (количество повторов каждого значения) задается первым аргументом.

Иллюстрация

OutRas = Popularity(ValRas, [InRas1, InRas2, InRas3])

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

• The tool evaluates the number of occurrences of the input raster values for each location and ranks them on an ordinal scale—то есть самый популярный (распространенный), второй по популярности и так далее. Он выдаст значение заданного 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) будет обрабатываться отдельно, как одноканальный растр.

• Если параметр Обработать как многоканальный включен, (в Python для process_as_multiband установлено значение MULTI_BAND), каждый ввод многоканального растра будет обрабатываться как многоканальный.

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

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

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

  Если все входные данные содержат одну переменную, но разные имена, снимите отметку Сопоставить многомерную переменную для среды геообработки (установите arcpy.env.matchMultidimensionalVariable = False в Python) перед выполнением операции.

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

• См. раздел Параметры среды анализа и Spatial Analyst для получения дополнительной информации о параметрах среды геообработки, применимых к этому инструменту.

Параметры

• Dialog
• Python

Подпись	Объяснение	Тип данных
Входной растр распространенности или константа	Входной растр, определяющий выдаваемое положение распространенности (популярности). В качестве входных данных может быть задано число; кроме того, необходимо указать экстент и размер ячейки в параметрах среды.	Raster Layer; Constant
Входные растры	Перечень входных растров, используемых для оценки распространенности значений для каждого местоположения ячейки.	Raster Layer
Обработать как многоканальный (Дополнительный)	Задает способ обработки каналов входного многоканального растра. Отмечено–Каждый многоканальный растр обрабатывается как многоканальный. Операция будет выполняться для каждого канала одних входных данных, с использованием номера соответствующего канала других входных данных. Не отмечено–Каждый канал многоканального растра обрабатывается отдельно, как одноканальный растр. Используется по умолчанию.	Boolean

Возвращаемое значение

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

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

Автоподтверждение, Размер ячейки, Метод проецирования размера ячейки, Сжатие, Текущая рабочая область, Экстент, Географические преобразования, Маска, Выходное ключевое слово конфигурации, Выходная система координат, Временная рабочая область, Растр привязки, Размер листа

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

• Basic: Требуется Spatial Analyst
• Standard: Требуется Spatial Analyst
• Advanced: Требуется Spatial Analyst

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

• Обзор группы инструментов Локальные
• Поиск инструмента геообработки
• Поиск значения из входного списка, соответствующего заданным критериям
• Ранг