ATan2 (Image 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) を掛ける必要があります。

  詳細については、操作手順と「[ラジアン単位の出力値を度単位に変換する例]」(converting-trigonometric-output-from-radians-to-degrees.md)をご参照ください。

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

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

• 一方の入力がマルチバンド ラスターで、他方の入力が定数である場合、ツールは、マルチバンド入力内の各バンドの定数値を使用して演算を実行し、出力はマルチバンド ラスターになります。

• 両方の入力が、同数の変数を含む多次元ラスター データの場合、このツールは、ディメンション値が同じすべてのスライスについて演算を実行します。 出力は CRF 形式の多次元ラスターになります。 このツールで処理を行うには、一般的なディメンションと一般的なディメンション値が入力の変数に少なくとも 1 つ必要です。これらがないとエラーが発生します。

  両方の入力に 1 つの変数が含まれているが、名前が異なっている場合は、このツールを実行する前に、多次元変数の照合ジオプロセシング環境をオフにします (Python で arcpy.env.matchMultidimensionalVariable = False を設定します)。

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

パラメーター

• Dialog
• Python

ラベル	説明	データ タイプ
入力ラスター、または定数値 1	逆正接値を計算する場合に使用する、分子または Y 値を指定する入力値。 他のパラメーターでラスターが指定されている場合、数値をこのパラメーターの入力として使用できます。 両方の入力で数値を指定するには、セル サイズと範囲を最初に環境で設定しておく必要があります。	Raster Layer; Constant
入力ラスター、または定数値 2	逆正接値を計算する場合に使用する、分母または X 値を指定する入力値。 他のパラメーターでラスターが指定されている場合、数値をこのパラメーターの入力として使用できます。 両方の入力で数値を指定するには、セル サイズと範囲を最初に環境で設定しておく必要があります。	Raster Layer; Constant

戻り値

ラベル	説明	データ タイプ
出力ラスター	出力ラスター。 値は、入力値の逆正接角度です。	Raster

環境

自動コミット, セル サイズ, セル サイズ投影法, 現在のワークスペース, 範囲, 地理座標系変換, マスク, 出力データのコンフィグレーション キーワード, 出力座標系, スクラッチ ワークスペース, スナップ対象ラスター, タイル サイズ

ライセンス情報

• Basic: Image Analyst または Spatial Analyst が必要
• Standard: Image Analyst または Spatial Analyst が必要
• Advanced: Image Analyst または Spatial Analyst が必要

関連トピック

• Image Analyst の三角関数演算ツールセットの概要
• ジオプロセシング ツールの検索
• ATan2 関数