ATan2 (Image Analyst)

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

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

概要

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

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

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

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

  • いずれの入力もマルチバンド ラスター、または入力のいずれかが定数の場合、出力はマルチバンド ラスターになります。各マルチバンド入力のバンド数は同じである必要があります。

  • ツールは、一方の入力の各バンドに対し、他方の入力の対応するバンドと対照して操作を行います。入力の一方がマルチバンド ラスターで他方が定数の場合、ツールはマルチバンド入力の各バンドの定数値と対照して操作を行います。

構文

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.ia import *
env.workspace = "C:/iapyexamples/data"
outATan2 = ATan2("degs", "negs")
outATan2.save("C:/iapyexamples/output/outatan2")
ATan2 の例 2 (スタンドアロン スクリプト)

この例では、2 つの入力 Grid ラスターの逆正接 (アーク タンジェント) を計算します。

# Name: ATan2_Ex_02.py
# Description: Calculates the inverse tangent of pixels based
#              on (y, x) values from two rasters
# Requirements: Image Analyst Extension

# Import system modules
import arcpy
from arcpy import env
from arcpy.ia import *

# Set environment settings
env.workspace = "C:/iapyexamples/data"

# Set local variables
inRaster1 = "degs"
inRaster2 = "negs"

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

# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)

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

ライセンス情報

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

関連トピック