Вычисляет арктангенс (на основе x,y) ячейки в растре.
Иллюстрация
OutRas = ATan2(InRas1, InRas2)
Использование
Инструмент ATan2 конвертирует прямоугольные координаты (x,y) в полярные (r,θ), где r - расстояние от начальной точки и θ - угол между осью x.
Конвертация прямоугольных координат в полярные
Для вычисления ATan2 используется следующее уравнение: tanθ = y / x (где θ — угол).
Операция ATan2 обрабатывает все квадранты в прямоугольной матрице (в зависимости от знака).
Значения первых входных данных используются как числитель в вычислении тангенса угла (y). Значения вторых входных данных используются как знаменатель в вычислении тангенса угла (x).
В математике все тригонометрические функции имеют определенный диапазон корректных входных значений, называемый доменом. Выходные значения каждой функции также имеют определенный диапазон. Для этого инструмента верно следующее:
Домен: -∞ < [in_value] < ∞
Этот домен применяется ко всем двум входным данным.
Диапазон: -pi < [out_value] ≤ pi
Обратите внимание, что здесь -∞ и ∞ являются, соответственно, наименьшим отрицательным и наибольшим положительным значением, поддерживаемыми определенным форматом растра.
Если оба значения – 0, выходным значением будет значение NoData.
Если первое входное значение – 0, выходное значение будет равно 0.
Входные значения инструмента ATan2 считаются линейными единицами, и для получения значимых результатов они должны быть в одних единицах.
Выходные значения всегда с плавающей точкой, независимо от типа входных данных.
Выходные значения этого инструмента – в радианах. Чтобы использовать в вычислениях градусы, значения результирующего растра должны быть умножены на коэффициент преобразования радиан в градусы 180/pi или приблизительно 57,296.
Если оба входных растра одноканальные либо одни из входных данных представлены константой, выходной растр будет одноканальным.
Если оба входных растра являются многоканальными, инструмент будет выполнять операцию над каждым из входных каналов, а выходной растр будет многоканальным. Количество каналов в каждом входном многоканальном растре должно быть одинаковым.
Если один из входных растров многоканальный, а другие входные данные являются константой, инструмент выполнит операцию со значением константы для каждого канала многоканального растра, а результатом будет многоканальный растр.
В ArcPy если все входные данные являются многомерными растрами с одинаковым количеством переменных, инструмент выполнит операцию для всех срезов с одинаковым значением измерения, а на выходе будет многомерный растр. Переменные во входных данных должны иметь одинаковую размерность или общую размерность, но никаких нетипичных измерений.
Если в обоих входных наборах данных есть одна переменная, но разные названия, задайте переменную геообработки matchMultidimensionalVariable как False, чтобы выполнить операцию.
В ArcPy если входные данные представлены многомерным растром и константой, инструмент выполнит операцию для всех срезов для всех переменных с постоянным значением, и на выходе будет многомерный растр.
Параметры
Подпись
Описание
Тип данных
Входной растр или постоянное значение 1
Входные данные, которые используются как числитель, или значение y, при вычислении арктангенса.
В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.
Raster Layer; Constant
Входной растр или постоянное значение 2
Входные данные, которые используются как знаменатель, или значение x, при вычислении арктангенса.
В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.
Raster Layer; Constant
Возвращаемое значение
Подпись
Описание
Тип данных
Выходной растр
Выходной растр.
Значениями является арктангенс угла входных значений.
Входные данные, которые используются как числитель, или значение y, при вычислении арктангенса.
В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.
Raster Layer; Constant
in_raster_or_constant2
Входные данные, которые используются как знаменатель, или значение x, при вычислении арктангенса.
В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды.
Raster Layer; Constant
Возвращаемое значение
Имя
Описание
Тип данных
out_raster
Выходной растр.
Значениями является арктангенс угла входных значений.
Raster
Пример кода
ATan2, пример 1 (окно Python)
В этом примере вычисляется обратный тангенс для двух входных растров GRID.
import arcpy
from arcpy import env
from arcpy.ia import *
env.workspace = "C:/iapyexamples/data"
outATan2 = ATan2("degs", "negs")
outATan2.save("C:/iapyexamples/output/outatan2")
ATan2, пример 2 (автономный скрипт)
В этом примере вычисляется обратный тангенс для двух входных растров GRID.
# Name: ATan2_Ex_02.py
# Description: Calculates the inverse tangent of pixels based
# on (y, x) values from two rasters
# Requirements: Image Analyst Extension
# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *
# Set environment settings
env.workspace = "C:/iapyexamples/data"
# Set local variables
inRaster1 = "degs"
inRaster2 = "negs"
# Check out the ArcGIS Image Analyst extension license
arcpy.CheckOutExtension("ImageAnalyst")
# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)
# Save the output
outATan2.save("C:/iapyexamples/output/outatan2.tif")
