rinkplanner/docs/manual.md
torsten 8f1cf1bf44 feat: strukturierte Sprungkombinationen
- PathSegment mit jump_kind und combination_jumps (max. 3 Sprünge)
- Base Value summiert strukturierte Kombinations-/Folgeteile
- Element-Dialog mit Art, zweitem und drittem Sprung; Level/Features
  bei Spruengen ausgeblendet
- Validator nutzt strukturierte Teile fuer Wiederholungen und Kombinationen
- Legacy-Freitext bleibt als Fallback lesbar
- 93 Model-, 169 Rules-, 70 Adult- und 288 Whiteboard-Assertions
  (1051 gesamt)
- Doku, Anleitung und Findings aktualisiert
2026-10-31 11:55:18 +01:00

6.4 KiB
Raw Blame History

Rinkplanner – Anleitung und Annahmen

Diese Anleitung erklärt die wichtigsten Begriffe und die Annahmen, die die App für Prüfung und Punktschätzung verwendet. Dieselbe Erklärung ist in der App über den Button ? in der Statusleiste erreichbar.

Schnellstart

  1. Kür anlegen oder öffnen.
  2. In der Statusleiste die Adult-Kategorie wählen (Gold, Silver, Bronze, Masters, Masters Elite).
  3. Elemente aufs Eis setzen: Linie, Bogen oder Element-Marker.
  4. Im Element-Dialog Kürzel, Features und ggf. Standzeit festlegen.
  5. Prüfen öffnen: Prüfliste, Befunde und Punktschätzung ansehen.

Kürzel und Base Value

  • Das Kürzel bezeichnet die Elementfamilie, z. B. 3Lz, CCoSp oder StSq.
  • Der Level ist die Schwierigkeitsstufe. Bei Pirouetten und Schrittsequenzen folgt er aus den Features.
  • Der Base Value wird aus Kürzel und Level im Saisonkatalog 2026/27 nachgeschlagen (ISU Communication 2786).
  • Sprünge haben keinen Level; ihr Base Value hängt von Rotation und Sprungtyp ab.
  • ChSq (Choreo-Sequenz) und ChSp (Choreographic Spin) sind fest Level 1.
  • Unbekannte Freitext-Codes haben keinen Katalogwert und werden in der Schätzung nicht gewertet.

Der Katalog wird jährlich ersetzt. Die Daten liegen unter rinkplanner/src/core/rules/data/ und tragen Saison, Quelle und Gültigkeitsdatum.

Sprungkombinationen

Sprungkombinationen und -folgen sind strukturiert:

  • Das Kürzel ist der erste Sprung, z. B. 3Lz.
  • Über Sprungkombination im Element-Dialog werden Art und weitere Sprünge gewählt:
    • Einzelsprung – keine weiteren Sprünge
    • Kombination – bis zu zwei weitere Sprünge, z. B. 3Lz+2T
    • Folge (SEQ) – bis zu zwei weitere Sprünge, Anzeige mit +SEQ
  • Die Base Values der einzelnen Sprünge werden summiert.
  • Wiederholungen und Kombinationsgrenzen werden anhand der strukturierten Teile geprüft, nicht mehr aus dem Kürzeltext geraten.
  • Alte Freitext-Kürzel wie 3Lz+2T werden weiterhin als Fallback gelesen und für Prüfung und Base Value geparst. Neu angelegte Elemente sollten die strukturierte Auswahl verwenden.

Level aus Features

Für Pirouetten und Schrittsequenzen gilt:

Anzahl Features Level
0 Base
1 Level 1
2 Level 2
3 Level 3
4 oder mehr Level 4
  • Pirouetten: 15 Features (2026/27). Maximal zwei schwierige Variationen zählen pro Pirouette. Für Level 4 ist zusätzlich eines dieser Features nötig: schwieriger Ausgang, klare Kantenänderung, beide Richtungen, klare Temposteigerung, schwieriger Flug-Eingang oder Windmills.
  • Schrittsequenzen: 5 Features. Feature 1 (Vielfalt schwieriger Schritte und Drehungen) ist Pflicht.
  • Features beschreiben die Ausführung. Die App kann sie nicht aus der gezeichneten Linie ableiten; sie werden im Element-Dialog ausgewählt.
  • Bei Katalog-Elementen ist der Level-Regler read-only. Der Level folgt aus den Features; Springe sind Base, ChSq/ChSp fest Level 1.

Adult-Kategorien

Die Kategorie wird in der Statusleiste gewählt und mit der Kür gespeichert.

Gold Silver Bronze
Dauer 2:50 ±10 s 2:00 ±10 s 1:40 ±10 s
Sprünge max. 5 max. 4 max. 4
Erlaubt Einfach/Double, ohne 2F/2Lz/2A/Triple nur Einfach inkl. 1A nur Einfach ohne Axel
Pirouetten max. 3, inkl. ChSp max. 2 max. 2
Sequenz 1 Schrittsequenz 1 ChSq 1 ChSq
Level-Cap Spins 3 / Sequenz 2 2 / 2 1 / 1
PCS-Faktor 2,67 2,00 2,00
Sturzabzug 1,0 0,5 außerhalb Elemente 0,5 außerhalb Elemente

Masters und Masters Elite sind ebenfalls wählbar. Grundlage ist das IAFSC Technical Announcement 2026/27; es hat bei Konflikten Vorrang vor allgemeinen ISU-Regeln.

Prüfung

Der Button Prüfen zeigt:

  • Kürzel im Katalog, Elementtyp und Level
  • Feature-Auswahl, Pflichtfeatures und Level aus Features
  • Einmal-pro-Programm-Features
  • bei Kategorie: Sprunganzahl, erlaubte Sprünge, Pirouetten, Sequenzen, Level-Grenzen, Pflichtelemente, Dauer, Wiederholungen und Kombinationen
  • Basiswert, PCS-Annahme, Sturzabzug und geschätzte Summe

Nicht anwendbare Prüfungen nennen den Grund, z. B. „nicht anwendbar (keine Features gesetzt)“. Warnungen blockieren Speichern und Export nicht.

Punktschätzung und Annahmen

Die Schätzung besteht aus drei Teilen:

Basiswert        = Summe der Base Values
PCS-Annahme      = Durchschnitt × 3 Komponenten × Kategorie-Faktor
Sturzabzug       = Anzahl Stürze × Kategorie-Abzug
Geschätzte Summe = Basiswert + PCS-Annahme - Sturzabzug

PCS-Annahme

PCS steht für Program Component Score. Im ISU-System bewerten die Judges drei Komponenten:

  • Composition – Aufbau, Muster, Musikbezug
  • Presentation – Ausdruck, Energie, Musikalität
  • Skating Skills – Kanten, Schritte, Kontrolle, Flow

Jede Komponente wird mit 0,25 bis 10,00 bewertet. Die drei Werte werden summiert und mit dem Kategorie-Faktor multipliziert.

Die App kennt keine echten Judge-Werte und arbeitet deshalb mit einem Durchschnitt pro Komponente (Startwert 5,00). Das ist eine Planungsannahme, kein Regelwert. Über ⓘ Annahmen ändern im Prüfdialog lassen sich Durchschnitt und Sturzzahl anpassen; beides wird mit der Kür gespeichert.

Beispiel Gold:

5,00 × 3 × 2,67 = 40,05 PCS
Basiswert 9,50
Geschätzte Summe 49,55

Was nicht enthalten ist

  • GOE (Ausführungsqualität der Judges)
  • 1,1-Faktor für die zweite Programmhälfte
  • nicht katalogisierte Kombinationen/Varianten
  • die offizielle Wettkampfwertung

Die Schätzung ist eine Planungshilfe, keine vorhergesagte Punktzahl. Für eine realistische PCS-Annahme helfen Protokolle früherer Wettkämpfe; der Durchschnitt sollte zum aktuellen Leistungsstand passen, nicht zum Wunschziel.

Grenzen

  • Features und PCS sind Eingaben, keine Messungen aus der Zeichnung.
  • Alte Freitext-Kombinationen werden noch geparst; neue Elemente nutzen die strukturierte Auswahl im Element-Dialog.
  • Max. zwei Features pro Fuß und Feature-Positionsregeln sind offen.
  • Adult-spezifische Sonderfälle außerhalb des Announcements 2026/27 sind nicht abgebildet.

Quellen

  • ISU Communication No. 2786 – Scale of Values 2026/27
  • ISU Communication No. 2788 – Levels of Difficulty / GOE 2026/27
  • IAFSC Technical Announcement 2026/27 (Adult-Wettbewerbe, Oberstdorf 2027)