ATan2 (Spatial Analyst)

Mit der Spatial Analyst-Lizenz verfügbar.

Mit der Image Analyst-Lizenz verfügbar.

Zusammenfassung

Den Arkustangens (auf Basis von x,y) von Zellen in einem Raster berechnen.

Abbildung

Abbildung "ATan2"
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.

    ATan2-Konvertierung
    Konvertierung von rechtwinkligen Koordinaten in Polarkoordinaten

    Die Gleichung zum Bestimmen von ATan2 lautet: tanθ = y/x (dabei ist θ der Winkel).

    Die Operation ATan2 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. 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 stattdessen Gradangaben verwenden möchten, 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.

    Zur weiteren Unterstützung sind eine Vorgehensweise sowie Beispiele zum Konvertieren der Ausgabe in Radiant in Grad verfügbar.

  • Wenn beide Eingaben Einzelband-Raster sind oder wenn eine der Eingaben eine Konstante ist, dann ist die Ausgabe ein Einzelband-Raster.

  • Wenn beide Eingaben Multiband-Raster sind, führt das Werkzeug den Vorgang für jedes Band aus einer Eingabe durch, und die Ausgabe ist ein Multiband-Raster. Die Anzahl an Bändern in jeder Multiband-Eingabe muss identisch sein.

  • Wenn eine der Eingaben ein Multiband-Raster und die andere Eingabe eine Konstante ist, führt das Werkzeug den Vorgang für jedes Band in der Multiband-Eingabe mit dem konstanten Wert durch. Die Ausgabe ist in diesem Fall ein Multiband-Raster.

  • Wenn beide Eingaben multidimensionale Raster-Daten mit derselben Anzahl an Variablen sind, führt das Werkzeug den Vorgang für alle Ausschnitte mit demselben Dimensionswert durch. Die Ausgabe ist ein multidimensionales Raster im CRF-Format. Die Variablen in den Eingaben müssen mindestens eine gemeinsame Dimension und einen gemeinsamen Dimensionswert enthalten, die von diesem Werkzeug verarbeitet werden sollen. Andernfalls tritt ein Fehler auf.

    Wenn beide Eingaben eine Variable, aber unterschiedliche Namen aufweisen, deaktivieren Sie vor dem Ausführen des Werkzeugs die Geoverarbeitungsumgebung Multidimensionale Variable abgleichen (durch Festlegen von arcpy.env.matchMultidimensionalVariable = False in Python).

    Wenn eine der Eingaben ein multidimensionales Raster und die andere Eingabe eine Konstante ist, führt das Werkzeug den Vorgang für alle Ausschnitte sämtlicher Variablen mit dem konstanten Wert durch, und die Ausgabe ist ein multidimensionales Raster.

  • Weitere Informationen zu den Geoverarbeitungsumgebungen für dieses Werkzeug finden Sie unter Analyseumgebungen und Spatial Analyst.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Raster oder konstanter Wert 1

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, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant
Eingabe-Raster oder konstanter Wert 2

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, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant

Rückgabewert

BeschriftungErläuterungDatentyp
Ausgabe-Raster

Das Ausgabe-Raster.

Die Werte ergeben den Arkustangenswinkel der Eingabewerte.

Raster

ATan2(in_raster_or_constant1, in_raster_or_constant2)
NameErläuterungDatentyp
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, müssen Sie 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, müssen Sie zunächst in der Umgebung die Zellengröße und die Ausdehnung festlegen.

Raster Layer; Constant

Rückgabewert

NameErläuterungDatentyp
out_raster

Das Ausgabe-Raster.

Die Werte ergeben den Arkustangenswinkel der Eingabewerte.

Raster

Codebeispiel

ATan2 – Beispiel 1 (Python-Fenster)

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")
ATan2 – Beispiel 2 (eigenständiges Skript)

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"

# Execute ATan2
outATan2 = ATan2(inRaster1, inRaster2)

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

Lizenzinformationen

  • Basic: Erfordert Spatial Analyst oder Image Analyst
  • Standard: Erfordert Spatial Analyst oder Image Analyst
  • Advanced: Erfordert Spatial Analyst oder Image Analyst

Verwandte Themen