ATan2 (Spatial 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。

  要获得更多帮助，可按照该步骤进行操作，并且可以使用将输出值从弧度转换为度的示例。

• 如果两个输入都是单波段栅格，或者输入之一是常量，则输出将是单波段栅格。

• 如果两个输入都是多波段栅格，或者输入之一是常量，则输出将是多波段栅格。每个多波段输入中的波段数必须相同。

• 该工具将在一个输入的每个波段上针对另一输入的相应波段执行操作。如果输入之一是多波段栅格，而另一个输入是常量，则该工具将针对多波段输入中每个波段的常量值执行操作。

• 有关适用于此工具的地理处理环境的详细信息，请参阅分析环境和 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"

# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)

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

环境

自动提交, 像元大小, 像元大小投影方法, 当前工作空间, 范围, 地理变换, 掩膜, 输出配置关键字, 输出坐标系, 临时工作空间, 捕捉栅格, 分块大小

许可信息

• Basic: 需要 Spatial Analyst 或 Image Analyst
• Standard: 需要 Spatial Analyst 或 Image Analyst
• Advanced: 需要 Spatial Analyst 或 Image Analyst