Recomposed
Canvas

atan, atan2 und atanh: Drei verschiedene Umkehrfunktionen, ein verwirrender Name

Oct 9, 2026 · 6 min read

atan, atan2 und atanh: Drei verschiedene Umkehrfunktionen, ein verwirrender Name

Was atan, atan2 und atanh tatsächlich sind

Drei Funktionen, die sich ein Namensmuster teilen und jeweils etwas anderes umkehren:

  • atan(ratio) kehrt tan um. Gib ihr eine einzelne Zahl, eine Steigung oder ein -Verhältnis, und sie liefert einen Winkel zurück, der immer irgendwo zwischen -90° und 90° liegt.
  • atan2(dy, dx) liefert ebenfalls einen Winkel zurück, aber aus dy und dx als zwei getrennten Zahlen statt aus einem bereits dividierten Verhältnis. Ihre Antworten decken den vollen Kreis ab, -180° bis 180°, nicht nur die Hälfte davon.
  • atanh(x) hat überhaupt nichts mit Winkeln zu tun. Sie kehrt um und dehnt eine Zahl, die bereits in (-1, 1) zusammengequetscht ist, wieder zu einer beliebigen reellen Zahl aus. Der Exkurs-Abschnitt gegen Ende dieses Beitrags behandelt sie für sich.

atan und atan2 teilen sich einen Wortstamm und kehren beide einen Tangens um; atanh teilt mit den beiden anderen nur das Namensmuster.

Die Intuition

"" klingt nach einer einzigen Funktion, daher ist es verlockend, atan, atan2 und atanh als austauschbare Schreibweisen derselben Idee zu behandeln. Das sind sie nicht, und besonders bei atan im Vergleich zu atan2 zeigt sich, wo diese Annahme scheitert:

  • tan(angle) hängt nur vom Verhältnis dy / dx ab. Zwei entgegengesetzte Punkte, wie (1, 1) und (-1, -1), erzeugen genau dasselbe Verhältnis, weil 1 / 1 und -1 / -1 beide 1 ergeben.
  • atan muss für dieses Verhältnis eine einzige Antwort zurückgeben. Sie wählt 45°, was für (1, 1) korrekt und für (-1, -1) falsch ist, das sich tatsächlich bei -135° befindet.
  • atan2 existiert speziell, um diesen Informationsverlust umzukehren. Sie liest dy und dx getrennt, sodass sie das Vorzeichen jedes einzelnen prüfen und alle vier Quadranten korrekt auflösen kann.

Das Drag-zu-Winkel-Beispiel aus Bildschirm-Koordinatensystemen stützte sich bereits genau aus diesem Grund auf atan2. Dieser Beitrag bleibt lange genug bei diesem einen Mechanismus, um zu sehen, warum atan dieselbe Aufgabe nicht erfüllen kann, egal wie die Eingabe aufbereitet wird.

Konkretes Beispiel: dasselbe Verhältnis, zwei verschiedene Richtungen

import kotlin.math.atan
import kotlin.math.atan2
 
val dy1 = 1.0; val dx1 = 1.0     // down-and-right (y grows downward on screen)
val dy2 = -1.0; val dx2 = -1.0   // up-and-left, the opposite direction
 
// Same ratio (1/1 == -1/-1), so atan returns the same angle for both,
// even though the two points face opposite ways.
Math.toDegrees(atan(dy1 / dx1))   // 45.0
Math.toDegrees(atan(dy2 / dx2))   // 45.0 (wrong, this point is at -135°)
 
// atan2 sees dy and dx separately instead of one pre-divided ratio, so
// it tells the two points apart correctly.
Math.toDegrees(atan2(dy1, dx1))   // 45.0
Math.toDegrees(atan2(dy2, dx2))   // -135.0

atan ist hier nicht fehlerhaft. Sie beantwortet die einzige Frage, die ihr gestellt wurde, nämlich „welchen Winkel hat dieser Tangens“, und ein einziges Verhältnis bildet tatsächlich auf zwei Winkel ab, die 180° voneinander entfernt sind. atan2 beantwortet eine andere Frage: „welcher Winkel führt zu diesem (dx, dy)-Punkt“, und die hat für jeden Punkt außer dem Ursprung selbst eine eindeutige Antwort.

atan(dy/dx): 0°

atan2(dy, dx): 0° — atan gives 0 degrees, atan2 gives the correct 0 degrees

Screen

drag the dot

Ziehe den Punkt durch alle vier Quadranten. atan2 verfolgt den wahren Winkel den gesamten Weg über. atan springt jedes Mal auf denselben Wert zurück, wenn die Ziehbewegung zum gespiegelten Punkt auf der anderen Seite der Mitte wechselt, weil das die einzige Eingabe ist, die sie jemals sieht.

The fundamental

atan2(dy, dx) ist eine Umkehrfunktion mit zwei Argumenten. Während atan(ratio) nur die Information zu sehen bekommt, die eine Division überlebt, erhält atan2 Zähler und Nenner, bevor überhaupt etwas dividiert wird, sodass sie den Quadranten zurückgewinnen kann, den ein einargumentiges Verhältnis bereits verworfen hat.

Sie ist keine Variante von atan mit besseren Standardwerten. Sie löst ein strikt größeres Problem: „in welche Richtung zeigt dieser Punkt“, nicht „welchen Winkel hat dieser Tangens“.

Anderswo: dasselbe Grundprinzip, anderes Framework

  • JavaScript: Math.atan2(y, x) nimmt dieselben zwei Argumente in derselben Reihenfolge, aus demselben Grund, bis hinunter zum (0, 0)- Grenzfall unten.
  • GLSL: atan(y, x), die zweiargumentige Überladung desselben Funktionsnamens, der auch für die einargumentige Version verwendet wird, löst in einem Fragment-Shader auf dieselbe Weise den vollen Bereich von -π bis π auf, häufig genutzt, um den Versatz eines Fragments von einem Mittelpunkt in einen Winkel für prozedurale Formen umzuwandeln.
  • Swift: atan2(y, x), direkt aus der libm von C importiert, ohne Argumentbezeichnungen, ist dieselbe Funktion unter demselben Namen, weil sich die zugrunde liegende Mathematik, und der Grund, warum ein zweites Argument nötig ist, sprachübergreifend nicht ändert.

Grenzfälle

kotlin.math.atan2 delegiert unter Android direkt an die Math.atan2 der JVM und erbt damit für jede Eingabe eine definierte Antwort, einschließlich der einen Eingabe, bei der „die Richtung zu diesem Punkt“ klingt, als dürfte es gar keine Antwort geben: dem Ursprung.

import kotlin.math.atan
import kotlin.math.atan2
 
val dy = 0.0
val dx = -0.0   // negative zero: a distinct, valid Double value
 
dy / dx          // NaN (0/0 is indeterminate no matter the signs involved)
atan(dy / dx)    // NaN, so there's no angle to read at all
 
atan2(dy, dx)    // ~3.14159 (π)

atan2 dividiert dy niemals durch dx, sodass sie der unbestimmten Form 0/0 überhaupt nicht ausgesetzt ist. Sie liest das Vorzeichen jeder Null direkt ab: positives dy, negatives dx wird als „zeigt in Richtung negatives x“ gelesen, was π ergibt. Dreht man dx zurück zu positiver Null, liefert atan2 stattdessen positive Null, eine andere Antwort für einen Double-Wert (-0.0), den == als gleich 0.0 behandelt. atan, das von einem Verhältnis ausgeht, das bereits zu NaN kollabiert ist, hat keine Möglichkeit, diese Fälle zu unterscheiden.

Wo atan2 sonst noch auftaucht

Drag-zum-Drehen-Regler und Blickrichtungslogik, wie die Drag-zu-Winkel-Demo aus dem begleitenden Beitrag über Bildschirm-Koordinatensysteme, sind zwei Einträge in einer viel längeren Liste. Immer wenn du aus einem (dx, dy)-Paar eine Richtung statt einer Distanz brauchst, ist atan2 normalerweise der Weg dazu.

UI- und Touch-Interaktion:

  • Drag-zum-Drehen-Regler und -Zifferblätter (Lautstärkeregler, Farbräder, kreisförmige Schieberegler, uhrenartige Auswahlelemente): Der Winkel von der Mitte zum Berührungspunkt steuert die Drehung.
  • Radial-/Kreismenüs: Prüfung, in welchem Segment ein Tipp gelandet ist, durch Berechnung des Winkels des Tipps relativ zur Mitte des Menüs.
  • Klassifizierung der Wischrichtung: Einordnung des atan2(dy, dx)- Werts eines Wischens in Bereiche wie oben/unten/links/rechts (oder 8 Richtungen).
  • Elemente, die dem Zeiger folgen: ein Pfeil oder eine Anzeige, die stets auf den Cursor zeigt, eine radiale Auswahlhervorhebung.

Bewegung und Ausrichtung:

  • Blickrichtung aus einem Geschwindigkeitsvektor: ein Sprite/Objekt so drehen, dass es in die Bewegungsrichtung zeigt, mittels atan2(dy, dx) seiner Verschiebung pro Frame.
  • „Anschauen“-/Zielrichtungslogik: Turmdrehung, Gegner-schaut-zu- Spieler in Spielen, Kamera-schaut-zu-Ziel.
  • Joystick-/Gamepad-Eingabe: Aufteilen der Rohwerte (x, y) eines Analogsticks in Richtung (Winkel) und Betrag (Radius) für 8-Richtungs-Bewegung oder die Behandlung von Totzonen.
  • Peilung zwischen zwei Punkten: atan2(y2 - y1, x2 - x1) für Navigation/Pfadfindung; die GPS-/Kompasskurs-Version ist dieselbe Idee auf einer Kugel.

Grafik und Datenvisualisierung:

  • Bogen- und Kreisdiagramm-Geometrie: Berechnung des Start-/Endwinkels eines Segments oder umgekehrt, in welchem Segment ein Klick gelandet ist.
  • Kartesisch-zu-polar-Umrechnung allgemein: überall dort, wo du (r, θ) aus (x, y) brauchst statt umgekehrt, der Oberbegriff, unter den jeder obige Punkt fällt.

Signalverarbeitung und andere Bereiche:

  • Argument einer komplexen Zahl: atan2(imaginary, real) liefert den Phasenwinkel einer komplexen Zahl.
  • I/Q-Demodulation in der digitalen Signalverarbeitung: Rückgewinnung der Phase aus In-Phase-/Quadratur-Komponenten.
  • Robotik: Berechnung des Kurses zu einem Wegpunkt aus aktueller Position und Ziel.

Eine andere Umkehrfunktion: atanh

atan und atan2 kehren beide eine Funktion um, die Winkel erzeugt. atanh kehrt stattdessen tanh um, die Zusammendrück-Funktion aus dem Intuitionsabschnitt oben, und das Ausführen dieser Umkehrung hat eine eigene Form: Sie wächst langsam in der Nähe von null und schießt dann gegen unendlich, wenn sich ihre Eingabe ±1 annähert, das Spiegelbild davon, wie schnell tanh an denselben Rändern abflacht.

Hier ist keine Ziehbewegung oder Drehung im Spiel. Das ist dieselbe Idee der „Umkehrfunktion“ wie bei atan2, nur angewendet auf ein völlig anderes Funktionspaar, und sie taucht weit entfernt von Android-UI-Code auf, an Orten, an denen ein Wert von Natur aus beschränkt ist und irgendetwas weiter unten im Ablauf ihn wieder unbeschränkt braucht.

atanh(x): 0.693

tanh(atanh(x)): 0.600 — atanh of 0.60 is 0.693, and tanh of that round-trips back to 0.600

x = 0.60

Ein konkretes Beispiel: Ein Korrelationskoeffizient r liegt immer in (-1, 1), was es unhandlich macht, direkt einen gewöhnlichen Signifikanztest darauf anzuwenden, da solche Tests etwas annehmen, das näher an einer Normalverteilung liegt. Die ist einfach atanh(r):

import kotlin.math.atanh
 
// r is bounded in (-1, 1); z is not, which is the entire point.
fun fisherZ(r: Double): Double = atanh(r)
 
fisherZ(0.6)    // 0.693
fisherZ(0.99)   // 2.647 (close to the edge, so z grows fast here)

kotlin.math.atanh ist in der Standardbibliothek enthalten und läuft problemlos unter Android, es gibt nur selten einen Grund, in UI-Code darauf zurückzugreifen, da UI-Code normalerweise derjenige ist, der einen beschränkten Wert erzeugt (eine Alpha, einen Fortschrittsanteil), und nicht derjenige, der die Beschränkung wieder aufheben muss.

Mentales Modell, das sich wirklich anwenden lässt

Eine Umkehrfunktion kann nur das zurückgeben, was ihre Eingabe sie sehen lässt: atan sieht ein zusammengefallenes Verhältnis und muss einen Quadranten raten, atan2 sieht zwei vorzeichenbehaftete Zahlen und muss nicht raten, und atanh sieht einen beschränkten Wert und dehnt ihn zurück in den unbeschränkten Bereich, aus dem tanh ihn herausgequetscht hatte.

Keep reading

Related reads

Neue Beiträge direkt in dein Postfach