Was atan, atan2 und atanh tatsächlich sind
Drei Funktionen, die sich ein Namensmuster teilen und jeweils etwas anderes umkehren:
atan(ratio)kehrttanum. 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 ausdyunddxals 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ältnisdy / dxab. Zwei entgegengesetzte Punkte, wie(1, 1)und(-1, -1), erzeugen genau dasselbe Verhältnis, weil1 / 1und-1 / -1beide1ergeben.atanmuss 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.atan2existiert speziell, um diesen Informationsverlust umzukehren. Sie liestdyunddxgetrennt, 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.
- →Screen Coordinate Systems Aren't CartesianThe drag-to-angle case this post keeps coming back to: why atan2 is the inverse that survives a y-down screen's flipped rotation direction.
- →Polar to Cartesian: What cos and sin Are Actually ComputingThe forward direction atan2 undoes: turning an angle and radius into an (x, y) point in the first place.
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.0atan 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.



