rinkplanner/docs/manual.md

170 lines
6.4 KiB
Markdown
Raw Normal View 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:
```text
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:
```text
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)