Частота равна (Spatial Analyst)

Доступно с лицензией Spatial Analyst.

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

Оценивает по принципу «ячейка-за-ячейкой» число равенства между набором растров и другим растром.

Иллюстрация

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

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

• В перечне входных растров может быть задано произвольное число растров.

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

• Выходной растр всегда будет целочисленным.

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

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

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

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

Параметры

Диалог

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

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

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

Python

EqualToFrequency(in_value_raster, in_rasters, {process_as_multiband})

Имя	Описание	Тип данных
in_value_raster	Для каждой ячейки входного растра значений определяется количество раз, когда значения из набора растров имеют равное значение значение.	Raster Layer
in_rasters [in_raster,...]	Список растров, которые будут сравниваться с растром значений.	Raster Layer
process_as_multiband (Дополнительный)	Задает способ обработки каналов входного многоканального растра. SINGLE_BAND—Каждый канал многоканального растра обрабатывается отдельно, как одноканальный растр. Используется по умолчанию. MULTI_BAND—Каждый многоканальный растр обрабатывается как многоканальный. Операция будет выполняться для каждого канала одних входных данных, с использованием номера соответствующего канала других входных данных.	Boolean

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

Имя	Описание	Тип данных
out_raster	Выходной растр. Для каждой ячейки выходного растра значение представляет количество раз, когда соответствующие ячейки из набора растров такие же, как растр значений.	Raster

Пример кода

Частота равна. Пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outETF = EqualToFrequency("cost", ["degs", "negs", "fourgrd"])
outETF.save("C:/sapyexamples/output/outetf.tif")

EqualToFrequency, пример 2 (автономный скрипт)

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

# Name: EqualToFrequency_Ex_02.py
# Description: Evaluates the number of times a set of rasters is
#              equal to another raster on a cell-by-cell basis
# 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
inValueRaster = "cost"
inRaster01 = "degs"
inRaster02 = "negs"
inRaster03 = "fourgrd"

# Execute EqualToFrequency
outETF = EqualToFrequency(inValueRaster, [inRaster01, inRaster02, inRaster03])

# Save the output 
outETF.save("C:/sapyexamples/output/outETF")

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

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

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

• Basic: Обязательно Spatial Analyst
• Standard: Обязательно Spatial Analyst
• Advanced: Обязательно Spatial Analyst