ATan2 (Spatial Analyst)
Zusammenfassung
Berechnet den Arkustangens (auf Grundlage von X,Y) von Zellen in einem Raster.
Bild
 |
OutRas = ATan2(InRas1, InRas2) |
Verwendung
-
ATan2 konvertiert rechtwinklige Koordinaten (X,Y) in polare Koordinaten (r,θ), wobei r die Entfernung vom Ursprung ist und θ der Winkel von der X-Achse.
Konvertierung von rechteckig zu PolarkoordinatenDie Gleichung zum Bestimmen von ATan2 lautet: tanθ = y/x (dabei ist θ der Winkel).
Der ATan2-Vorgang stellt alle Quadranten in einer kartesischen Matrix (basierend auf dem Zeichen) dar.
-
Die Werte der ersten Eingabe werden bei der Berechnung des Tangentenwinkels (Y) als Zähler verwendet. Die Werte der zweiten Eingabe werden bei der Berechnung des Tangentenwinkels (X) als Nenner verwendet.
In der Mathematik verfügen alle trigonometrischen Funktionen über einen definierten Bereich gültiger Eingabewerte, der als Domäne bezeichnet wird. Die Ausgabewerte jeder Funktion haben ebenfalls einen definierten Bereich. Für dieses Werkzeug gilt Folgendes:
Die Domäne ist: -∞ < [in_value] < ∞
Diese Domäne gilt für beide Eingaben.
Der Bereich ist: -pi < [out_value] ≤ pi
Beachten Sie, dass -∞ und ∞ den kleinsten negativen und größten positiven Wert darstellen, die von dem jeweiligen Raster-Format unterstützt werden.
-
Wenn beide Eingabewerte 0 sind, wird NoData ausgegeben.
Wenn der erste Eingabewert 0 beträgt, ist die Ausgabe 0.
-
Die Eingabewerte für ATan2 werden als lineare Einheiten interpretiert und um sinnvolle Ergebnisse zu erhalten, sollten beide dieselbe Einheit aufweisen.
Die Ausgabewerte sind immer Gleitkommawerte, unabhängig vom Eingabedatentyp.
Die Ausgabewerte dieses Werkzeugs werden in Radiant angegeben. Wenn Sie Gradangaben wünschen, muss das resultierende Raster mit dem Konvertierungsfaktor für die Umwandlung von Radiant in Grad von 180/Pi oder ungefähr 57,296 multipliziert werden.
Beispiele für die Konvertierung der Ausgabewerte von Radiant in Grad finden Sie hier.
Syntax
| Parameter | Erläuterung | Datentyp |
in_raster_or_constant1 |
Die Eingabe, die den Zähler oder Y-Wert angibt und beim Berechnen des Arkustangens verwendet werden soll. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, Sie müssen zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen. | Raster Layer | Constant |
in_raster_or_constant2 |
Die Eingabe, die den Nenner oder X-Wert angibt und beim Berechnen des Arkustangens verwendet werden soll. Für diesen Parameter kann eine Zahl als Eingabe verwendet werden, vorausgesetzt für den anderen Parameter wird ein Raster angegeben. Wenn Sie für beide Eingaben eine Zahl angeben möchten, Sie müssen zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen. | Raster Layer | Constant |
Rückgabewert
| Name | Erläuterung | Datentyp |
| out_raster |
Das Ausgabe-Raster. Die Werte ergeben den Arkustangenswinkel der Eingabewerte. | Raster |
Codebeispiel
In diesem Beispiel wird der Arkustangens für zwei Eingabe-GRID-Raster berechnet.
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")
In diesem Beispiel wird der Arkustangens für zwei Eingabe-GRID-Raster berechnet.
# 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")