Доступно с лицензией Spatial Analyst.
Доступно с лицензией Image Analyst.
Сводка
Вычисляет арктангенс (на основе x,y) ячейки в растре.
Иллюстрация
Использование
Инструмент 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.
В качестве дополнительной справки имеется описание процедуры и примеры конвертации входных значений из радиан в градусы.
Если оба входных набора данных являются одноканальными растрами, либо один из входных параметров является константой, то выходной результат будет одноканальным растром.
Если оба входных набора данных являются многоканальными растрами, либо один из входных параметров является константой, то выходной результат будет многоканальным растром. Число каналов в каждом входном многоканальном растре должно быть одинаковым.
Инструмент будет выполнять операцию для каждого канала из входных данных по отношению к соответствующему каналу из другого входного набора данных. Если один из входных наборов данных является многоканальным растром, а другой - константой, то инструмент будет выполнять операцию со значением константы для каждого канала в многоканальном растре.
См. раздел Среда анализа и Spatial Analyst для получения дополнительной информации о среде геообработки данного инструмента.
Синтаксис
ATan2(in_raster_or_constant1, in_raster_or_constant2)
| Parameter | Объяснение | Тип данных |
in_raster_or_constant1 | Входные данные, которые используются как числитель, или значение y, при вычислении арктангенса. В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды. | Raster Layer; Constant |
in_raster_or_constant2 | Входные данные, которые используются как знаменатель, или значение x, при вычислении арктангенса. В качестве входных данных для этого параметра может использоваться число, при условии, что для другого параметра задан растр. Чтобы задать число для двух входных данных, необходимо сперва указать экстент и размер ячейки в параметрах среды. | Raster Layer; Constant |
Значение отраженного сигнала
| Name | Объяснение | Тип данных |
| out_raster | Выходной растр. Значениями является арктангенс угла входных значений. | Raster |
Пример кода
В этом примере вычисляется обратный тангенс для двух входных растров GRID.
import arcpy
from arcpy import env
from arcpy.sa import *
env.workspace = "C:/sapyexamples/data"
outATan2 = ATan2("degs", "negs")
outATan2.save("C:/sapyexamples/output/outatan2")В этом примере вычисляется обратный тангенс для двух входных растров GRID.
# Name: ATan2_Ex_02.py
# Description: Calculates the inverse tangent of cells based
# on (y, x) values from two rasters
# 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 = "negs"
# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)
# Save the output
outATan2.save("C:/sapyexamples/output/outatan2.tif")Environments
Информация о лицензиях
- Basic: Требуется Дополнительный модуль Spatial Analyst или Image Analyst
- Standard: Требуется Дополнительный модуль Spatial Analyst или Image Analyst
- Advanced: Требуется Дополнительный модуль Spatial Analyst или Image Analyst