ATan2 (Spatial Analyst)

Spatial Analyst のライセンスで利用可能。

Image Analyst ライセンスで利用できます。

サマリー

ラスターのセル値の (x/y に基づいた) 逆正接を計算します。

ATan2 の図
OutRas = ATan2(InRas1, InRas2)

使用法

  • [ATan2] ツールは、直交座標 (X,Y) を極座標 (R,θ) に変換します。この場合、R は原点からの距離で θ は X 軸からの角度です。

    ATan2 変換
    直交座標から極座標への変換

    ATan2 の判別式は、tanθ = y / x (θ は角度) です。

    ATan2 処理は、デカルト マトリックス (sin に基づく) のすべての象限を表します。

  • 最初の指定された入力値は、正接角度 (Y) の計算の分子として使用されます。 2 つ目の指定された入力値は、角度 (X) の計算の分母として使用されます。

  • 数学では、すべての三角関数にドメイン (定義域) と呼ばれる有効な入力値の範囲が定義されています。 各関数の出力値も範囲が定義されています。 このツールの場合、以下が当てはまります。

    • ドメイン : -∞ < [in_value] < ∞

      このドメインは両方の入力値に適用されます。

    • 範囲: -pi < [out_value] ≤ pi

    -∞ と ∞ はそれぞれ、特定のラスター形式でサポートされている負の最小値と正の最大値を表します。

  • 両方の入力値が 0 の場合には、出力は NoData になります。

    最初の入力値が 0 の場合には、出力は 0 になります。

  • [ATan2] ツールへの入力値は、線形単位として解釈され、意味のある結果を得るためには両者は同じ単位でなければなりません。

  • 出力値は、入力データ タイプに関係なく常に浮動小数点値です。

  • このツールの出力値はラジアンで表されます。 代わりに角度を使用するには、結果のラスターに変換係数 180/pi (およそ 57.296) を掛ける必要があります。

    詳細については、操作手順と「ラジアン単位の出力値を度単位に変換する例」をご参照ください。

  • 両方の入力がシングルバンド ラスターである場合、またはいずれかの入力が定数である場合、出力はシングルバンド ラスターになります。

  • 両方の入力がマルチバンド ラスターである場合、ツールは 1 つの入力の各バンドに対して演算を実行し、出力はマルチバンド ラスターになります。 各マルチバンド入力のバンド数は同一である必要があります。

  • 入力のうちの 1 つがマルチバンド ラスターであり、もう 1 つが定数である場合、ツールはマルチバンド入力に含まれるバンドごとに定数値を使用して演算を実行し、出力はマルチバンド ラスターになります。

  • ArcPy では、両方の入力が、同数の変数を含む多次元ラスターの場合、このツールは、ディメンション値が同じすべてのスライスについて演算を実行し、出力は多次元ラスターになります。 入力に含まれる変数には同じディメンションまたは共通のディメンションが必要です。共通でないディメンションが存在してはなりません。

    両方の入力に 1 つの変数が含まれているが、名前が異なっている場合は、演算を実行するために、matchMultidimensionalVariable ジオプロセシング環境を False に設定します。

    ArcPy では、入力のいずれかが多次元ラスターで、それ以外の入力が定数である場合、このツールは、すべての変数のすべてのスライスについて、その定数値を使用して演算を実行し、出力は多次元ラスターになります。

  • このツールに適用されるジオプロセシング環境の詳細については、「解析環境と Spatial Analyst」をご参照ください。

パラメーター

ラベル説明データ タイプ
入力ラスター、または定数値 1

逆正接値を計算する場合に使用する、分子または Y 値を指定する入力値。

他のパラメーターでラスターが指定されている場合、数値をこのパラメーターの入力として使用できます。 両方の入力で数値を指定するには、セル サイズと範囲を最初に環境で設定しておく必要があります。

Raster Layer; Constant
入力ラスター、または定数値 2

逆正接値を計算する場合に使用する、分母または X 値を指定する入力値。

他のパラメーターでラスターが指定されている場合、数値をこのパラメーターの入力として使用できます。 両方の入力で数値を指定するには、セル サイズと範囲を最初に環境で設定しておく必要があります。

Raster Layer; Constant

戻り値

ラベル説明データ タイプ
出力ラスター

出力ラスター。

値は、入力値の逆正接角度です。

Raster

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 ウィンドウ)

この例では、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")
ATan2 の例 2 (スタンドアロン スクリプト)

この例では、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

関連トピック