ATan2 (Spatial Analyst)
サマリ
ラスタ内のセル値の逆正接（X、Y に基づく）を計算します。
図
 |
OutRas = ATan2(InRas1, InRas2) |
使用法
-
[ATan2] ツールは、直交座標（X、Y）を極座標（R、θ）に変換します。この場合、R は原点からの距離で θ は X 軸からの角度です。
直交座標を極座標に変換します。ATan2 の判別式は、tanθ = y / x （θ は 角度）です。
ATan2 処理は、デカルト マトリックス（sin に基づく）のすべての象限を表します。
-
最初の指定された入力値は、正接角度（Y）の計算の分子として使用されます。2 つめの指定された入力値は、角度（X）の計算の分母として使用されます。
数学の場合、すべての三角関数にドメイン（定義域）と呼ばれる有効な入力値の範囲が定義されています。各関数の出力値も範囲が定義されています。このツールの場合は以下のとおりです。
ドメインは-∞ < [in_value] < ∞
このドメインは両方の入力値に適用されます。
範囲は-pi < [out_value] ≤ pi
ここでは、-∞ と ∞ はそれぞれ、特定のラスタ形式でサポートされている負の最小値と正の最大値を表します。
-
両方の入力値が 0 の場合には、出力は NoData になります。
最初の入力値が 0 の場合には、出力は 0 になります。
-
[ATan2] ツールへの入力値は、線形単位として解釈され、意味のある結果を得るためには両者は同じ単位でなければなりません。
出力値は、入力データ型に関わらず常に浮動小数点数です。
このツールの出力値はラジアンで表されます。角度単位が望ましい場合は、結果のラスタに変換係数 180/pi（およそ 57.296）を掛ける必要があります。
出力値をラジアンから角度に変換する例については、ここをご参照ください。
構文
| パラメータ | 説明 | データ タイプ |
in_raster_or_constant1 |
逆正接（アーク タンジェント）値を計算する場合に使用する、分子または Y 値を指定する入力値 他のパラメータでラスタが指定されている場合、数値をこのパラメータの入力として使用できます。両方の入力で数値を指定するには、セル サイズと範囲を最初に環境で設定しておく必要があります。 | Raster Layer | Constant |
in_raster_or_constant2 |
逆正接（アーク タンジェント）値を計算する場合に使用する、分母または X 値を指定する入力値 他のパラメータでラスタが指定されている場合、数値をこのパラメータの入力として使用できます。両方の入力で数値を指定するには、セル サイズと範囲を最初に環境で設定しておく必要があります。 | Raster Layer | Constant |
戻り値
| 名前 | 説明 | データ タイプ |
| out_raster |
出力ラスタ。 この値は入力値の逆正接（アーク タンジェント）角度です。 | Raster |
コードのサンプル
この例では、2 つの入力 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")
この例では、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")