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

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

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

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

Иллюстрация

Пример входных и выходных значений инструмента Частота равна
OutRas = EqualToFrequency(ValRas, [InRas1, InRas2, InRas3])

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

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

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

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

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

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

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

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

Параметры

ПодписьОписаниеТип данных
Входной растр значений

Для каждой ячейки входного растра значений определяется количество раз, когда значения из набора растров имеют равное значение значение.

Raster Layer
Входные растры

Список растров, с которым сравнивается входной растр.

Raster Layer
Обработать как многоканальный
(Дополнительный)

Задает способ обработки каналов входного многоканального растра.

  • Не отмечено – каждый канал многоканального растра будет обработан отдельно как одноканальный растр. Это значение по умолчанию
  • Отмечено – каждый многоканальный входной растр будут обрабатываться как многоканальный растр. Эта операция будет выполнятся для каждого канала из входного набора с использованием соответствующего номера канала для остальных входных данных.
Boolean

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

ПодписьОписаниеТип данных
Выходной растр

Выходной растр.

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

Raster

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 (автономный скрипт)

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

# 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")

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

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

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