docs: document spin rotation and jump distance assumptions

This commit is contained in:
torsten 2026-11-10 15:49:54 +01:00
parent de4ff8cae7
commit e9d520459e

View file

@ -125,7 +125,64 @@ Orientierung für Rinkplanung und Playback:
Beispiel: 20 m in 4,4 s → 4,55 m/s (16,4 km/h).
## 8. Offene Punkte
## 8. Pirouetten-Rotation im Playback
Der Playback-Marker dreht sich während der Standzeit einer Pirouette mit einer
festen Rate. Sie ist reine Visualisierung und geht nicht in Dauer oder Wertung
ein. Bisher waren **1,5 U/s** angesetzt; das wirkt im 2D-Playback träge.
Recherchestand (10.11.2026):
| Quelle | Wert |
| :--- | ---: |
| Arme/Bein ausgestreckt (Lehrbuchbeispiel) | ca. 2 U/s |
| Übliche moderne Pirouetten (Lagewechsel, Kombinationen) | ca. 2–3 U/s |
| Spitzenwerte Upright/Scratch (Biellmann, Ruh, Robertson) | bis 5 U/s |
| Guinness-Weltrekord Olivia Oliver 2015 | 342 U/min ≈ 5,7 U/s |
Quellen: Wikipedia „Figure skating spins“ (Cabell & Bateman 2018; Guinness
World Records); Physik-Lehrbuchbeispiel zur Drehimpulserhaltung (2 U/s mit
ausgestreckten Gliedmaßen).
Umgesetzt ist deshalb **2,5 U/s** (`WhiteboardController.
SPIN_REVOLUTIONS_PER_SECOND`). Das liegt im Bereich heutiger
Wettkampfpirouetten und ist sichtbar schneller als der alte Wert, ohne wie ein
Kreisel zu wirken.
Seit 10.11.2026 ist die Rate nicht mehr fest: Jeder Pirouetten-Marker speichert
eine **Umdrehungszahl** (`element_revolutions`). Der Playback dreht mit
`Umdrehungen / Standzeit`; der konstante Wert 2,5 U/s dient nur noch als
Fallback für alte Dateien ohne Feld (und als Startwert neuer Marker: bei 4 s
Standard-Standzeit 10 Umdrehungen, das ISU-Minimum einer Kombination). Im
Element-Dialog stehen Standzeit und
Umdrehungen nebeneinander, das Label zeigt die resultierende Rate live an.
Damit lässt sich z. B. „10 Umdrehungen in 4 s“ (2,5 U/s) oder „8 U in 6 s“
(1,33 U/s) planen; die Umdrehungszahl ist die regelrelevante Größe, nicht die
Rate.
**Drehrichtung:** Etwa **85–90 % der Eiskunstläufer** drehen Sprünge und
Pirouetten gegen den Uhrzeigersinn (linksherum); rechtsherum ist die Ausnahme
(„lefty“). Quellen: Wikipedia „Figure skating spins“ sowie einschlägige
Trainings- und Lehrquellen (Balletfocus nennt ca. 90 %). Deshalb ist
`element_rotation_direction` pro Pirouetten-Marker konfigurierbar und steht
standardmäßig auf **linksherum**. Der Playback rechnet in Godots
2D-Bildschirmkoordinaten (y nach unten), dort sind positive Winkel im
Uhrzeigersinn; linksherum entspricht daher dem negativen Vorzeichen. Alte
Kürdateien ohne das Feld werden ebenfalls linksherum interpretiert – die
bisherige feste Rechtsdrehung war eine falsche Annahme.
**Sprungvektor und Luftphase:** Ein Sprung dreht immer in der Luft, ein-
bis viermal je nach Sprung (Axel zusätzlich eine halbe Umdrehung). Die
Umdrehungszahl wird aus dem Kürzel gelesen (`3Lz` → 3, `2A` → 2,5) und der
Marker dreht sich beim Abspielen entsprechend über die Standzeit. Die
angezeigte Sprungweite ist eine Planungsannahme von **1 m pro
Luftumdrehung** (`JUMP_METERS_PER_REVOLUTION`): `1S` ≈ 1 m, `2A` ≈ 2,5 m,
`3Lz` ≈ 3 m. Reale Weiten hängen von Tempo, Technik und Sprungart ab; bis die
Pfeilspitze im Canvas gezogen wird, gilt die Kürzel-Heuristik. Danach speichert
der Marker den gezogenen Vektor (`element_jump_vector`) und die Weite folgt
ihm.
## 9. Offene Punkte
- Die Datenlage für Adult-Bereich, Ice Dance und Paarlauf ist dünn.
- Sprunglandungen und Übergänge sind in den Quellen nicht einheitlich erfasst.