ATan2 (Image Analyst)

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

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

Сводка

Вычисляет арктангенс (на основе 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.

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

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

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

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

Синтаксис

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

Пример кода

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

Environments

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

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

• Basic: Требуется Image Analyst or Spatial Analyst
• Standard: Требуется Image Analyst or Spatial Analyst
• Advanced: Требуется Image Analyst or Spatial Analyst