Справка

ATan2

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

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

Вычисляет арктангенс (по параметру x,y) ячеек растра.

Рисунок

Иллюстрация инструмента ATan2
OutRas = ATan2(InRas1, InRas2)

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

  • Инструмент ATan2 конвертирует прямоугольные координаты (x,y) в полярные (r,θ), где r – расстояние от начальной точки и θ – угол между осью x.

    Конвертация ATan2
    Конвертация прямоугольных координат в полярные

    Для вычисления 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)
ПараметрОбъяснениеТип данных
in_raster_or_constant1

Входные данные, которые используются как числитель, или значение 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.sa import *
env.workspace = "C:/sapyexamples/data"
outATan2 = ATan2("degs", "negs")
outATan2.save("C:/sapyexamples/output/outatan2")
ATan2. Пример 2 (автономный скрипт)

В этом примере вычисляется обратный тангенс для двух входных растров 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"

# Check out the ArcGIS Spatial Analyst extension license
arcpy.CheckOutExtension("Spatial")

# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)

# Save the output 
outATan2.save("C:/sapyexamples/output/outatan2.tif")

Параметры среды

Связанные темы

Отзыв по этому разделу?