Степень (Spatial Analyst)

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

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

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

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

Иллюстрация

Рисунок инструмента Степень
OutRas = Power(InRas1, 2)

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

  • Выходной растр этого инструмента всегда имеет тип с плавающей точкой, независимо от типа входных значений.

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

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

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

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

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

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

  • В Алгебре карт эквивалентным символом для этого оператора является "**" (ссылка).

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

Параметры

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

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

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

Raster Layer; Constant
Входной растр или постоянное значение 2

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

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

Raster Layer; Constant

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

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

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

Значениями ячеек является результат возведения значений первых входных данных в степень значений вторых входных данных.

Raster

Power(in_raster_or_constant1, in_raster_or_constant2)
ИмяОписаниеТип данных
in_raster_or_constant1

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

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

Raster Layer; Constant
in_raster_or_constant2

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

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

Raster Layer; Constant

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

ИмяОписаниеТип данных
out_raster

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

Значениями ячеек является результат возведения значений первых входных данных в степень значений вторых входных данных.

Raster

Пример кода

Power, пример 1 (окно Python)

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

import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outPower = Power("degs", "cost")
outPower.save("C:/sapyexamples/output/outpower.img")
Power, пример 2 (автономный скрипт)

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

# Name: Power_Ex_02.py
# Description: Raises the cells in a raster to the power of the values
#              found in another raster
# 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
inRaster1 = "degs"
inRaster2 = "cost"

# Execute Power
outPower = Power(inRaster1, inRaster2)

# Save the output 
outPower.save("C:/sapyexamples/output/outpower.img")

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

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

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