106 lines
5.3 KiB
Markdown
106 lines
5.3 KiB
Markdown
|
|
# Findings – Session: ISU-Level-Features (2026-10-31)
|
|||
|
|
|
|||
|
|
Ergänzung zu `docs/findings-2026-10-31-isu-katalog.md`.
|
|||
|
|
Nach dem Base-Value-Katalog folgt die zweite ISU-Ausbaustufe: Level-Features
|
|||
|
|
für Pirouetten und Schrittsequenzen samt Level-Berechnung und Auswahl im
|
|||
|
|
Element-Inspector.
|
|||
|
|
|
|||
|
|
## Ergebnis
|
|||
|
|
|
|||
|
|
| Ziel | Ergebnis |
|
|||
|
|
| :--- | :--- |
|
|||
|
|
| Feature-Daten | `isu_levels_2025_26.json` aus ISU Communication No. 2701 |
|
|||
|
|
| Feature-Modell | `ElementFeature`, `ElementLevelRules` in `src/core/rules/` |
|
|||
|
|
| Umfang | 14 Pirouetten-Features, 4 Schrittsequenz-Features |
|
|||
|
|
| Level-Berechnung | 1 Feature → Level 1 … 4 Features → Level 4; Level-4-Voraussetzungen |
|
|||
|
|
| Speicherung | `PathSegment.element_features` (Codes, Duplikate erlaubt) |
|
|||
|
|
| Bedienung | Button „Features (n)“ mit Checkbox-Menü, Hinweis auf abgeleitetes Level |
|
|||
|
|
| Tests | 833 Assertions gesamt, `./tools/test.sh` grün (neu: 47 Level-Tests) |
|
|||
|
|
|
|||
|
|
## Quelle und Regeln
|
|||
|
|
|
|||
|
|
- ISU Communication No. 2701, *Single & Pair Skating – Levels of Difficulty
|
|||
|
|
and Guidelines for marking Grade of Execution and Program Components,
|
|||
|
|
Season 2025/26* (ersetzt Communication 2623).
|
|||
|
|
- Schwellen: 1 Feature → Level 1, 2 → Level 2, 3 → Level 3, 4 oder mehr →
|
|||
|
|
Level 4; ohne Feature Base.
|
|||
|
|
- **Pirouetten:** 14 Features. Schwierige Variationen zählen höchstens zweimal
|
|||
|
|
pro Pirouette. Für Level 4 ist zusätzlich eines von sechs Features nötig:
|
|||
|
|
schwieriger Positionswechsel, schwieriger Ausgang, klare Kantenänderung,
|
|||
|
|
beide Richtungen, klare Temposteigerung oder schwieriger Flug-Eingang.
|
|||
|
|
- **Schrittsequenzen:** 4 Features. Feature 1 (Vielfalt schwieriger Schritte
|
|||
|
|
und Drehungen) ist Pflicht; ohne sie bleibt die Sequenz Base, auch wenn
|
|||
|
|
andere Features gesetzt sind.
|
|||
|
|
- **Choreografische Sequenz (`ChSq`):** fest Level 1, unabhängig von Features.
|
|||
|
|
- **Sprünge:** nicht levelbar.
|
|||
|
|
|
|||
|
|
## Entscheidungen
|
|||
|
|
|
|||
|
|
- **Features sind Codes am Segment.** `element_features` ist eine
|
|||
|
|
`PackedStringArray`; Duplikate sind erlaubt, damit zwei schwierige
|
|||
|
|
Variationen als zwei Features zählen. Die Reihenfolge bleibt erhalten.
|
|||
|
|
- **Typwechsel leert die Auswahl.** Features sind typabhängig; `set_element`
|
|||
|
|
verwirft sie beim Wechsel des Elementtyps und beim Entfernen des Elements.
|
|||
|
|
- **Das Level bleibt eine Autorengröße.** Die Berechnung erzeugt nur einen
|
|||
|
|
Hinweis (`Features: 2 · Level 2 · gewählt: Level 4`). Der Inspector ändert
|
|||
|
|
das gewählte Level nicht stillschweigend. So bleiben Altdaten und bewusste
|
|||
|
|
Overrides sichtbar; die Validierung kann später Abweichungen melden.
|
|||
|
|
- **Eigene JSON-Datei.** Level-Features stammen aus einer anderen
|
|||
|
|
Communication als die Base Values und ändern sich unabhängig. Beide Dateien
|
|||
|
|
tragen Saison, Quelle und Gültigkeitsdatum.
|
|||
|
|
- **PopupMenu statt Unterdialog.** Der Button öffnet eine Checkbox-Liste am
|
|||
|
|
Button. `hide_on_checkable_item_selection` ist aus, damit mehrere Features
|
|||
|
|
ohne erneutes Öffnen gewählt werden können. Checkable PopupMenu-Einträge
|
|||
|
|
toggeln sich in Godot nicht selbst; der Controller toggelt im
|
|||
|
|
`id_pressed`-Handler.
|
|||
|
|
- **Auswahl wird beim Schließen übernommen.** `popup_hide` sammelt die
|
|||
|
|
markierten Einträge und ruft `set_selected_element_features`; die Änderung
|
|||
|
|
ist undo-fähig und dirty-markierend.
|
|||
|
|
|
|||
|
|
## Bedienung
|
|||
|
|
|
|||
|
|
- Im Element-Inspector steht unter dem Base Value der Button `Features (n)`.
|
|||
|
|
- Bei Sprüngen ist er deaktiviert und der Hinweis erklärt, dass Sprünge keine
|
|||
|
|
Level-Features haben. Bei Sequenzen ohne Kürzel oder unbekanntem Kürzel
|
|||
|
|
bleibt er ebenfalls deaktiviert.
|
|||
|
|
- Das Menü zeigt alle Features des Typs; schwierige Variationen erscheinen
|
|||
|
|
zweimal (`1/2`, `2/2`). Tooltips erklären die Features.
|
|||
|
|
- „Auswahl zurücksetzen“ entfernt alle Haken.
|
|||
|
|
- Der Hinweis darunter nennt Feature-Anzahl, abgeleitetes Level, eine
|
|||
|
|
Abweichung zum gewählten Level und ggf. ignorierte Features.
|
|||
|
|
- Fehlt bei einer Schrittsequenz das Pflichtfeature, steht dort
|
|||
|
|
„Pflichtfeature fehlt: variety_of_turns“.
|
|||
|
|
|
|||
|
|
## Grenzen
|
|||
|
|
|
|||
|
|
1. **Programmweite Grenzen:** `once_per_program` ist in den Daten, wird aber
|
|||
|
|
noch nicht ausgewertet. Features 2–9 und 11–14 zählen laut ISU nur beim
|
|||
|
|
ersten Versuch im Programm.
|
|||
|
|
2. **Maximal zwei Features pro Fuß:** Bei Pirouetten mit Fußwechsel ist die
|
|||
|
|
Ausbeute pro Fuß begrenzt. Das Modell kennt keine Füße und kann das nicht
|
|||
|
|
prüfen.
|
|||
|
|
3. **Feature-Kombinationen:** Die Regel „Feature nicht zusammen mit einer
|
|||
|
|
bereits verwendeten Variationsposition“ ist nicht modelliert.
|
|||
|
|
4. **Adult-Abweichungen:** Die Datei enthält die regulären ISU-Regeln, keine
|
|||
|
|
Adult-spezifischen Erleichterungen.
|
|||
|
|
5. **GOE und Varianten:** GOE-Tabellen, `V`-, `q`-, `e`-, `!`-, `<`- und
|
|||
|
|
`<<`-Varianten fehlen weiterhin.
|
|||
|
|
|
|||
|
|
## Tests
|
|||
|
|
|
|||
|
|
Neu: `tests/run_level_tests.gd` (47 Assertions)
|
|||
|
|
|
|||
|
|
- Metadaten, Saison, Quelle und Feature-Anzahl
|
|||
|
|
- Schwellen 0–4 Features, Duplikate schwieriger Variationen, Ignorieren
|
|||
|
|
überzähliger Variationen
|
|||
|
|
- Level-4-Voraussetzung: vier Features ohne Spezialfeature bleiben Level 3
|
|||
|
|
- Pflichtfeature der Schrittsequenz, `ChSq` fest Level 1, Sprünge ohne Level
|
|||
|
|
- `validate_selection` für unbekannte, überzählige und fehlende Features
|
|||
|
|
- Segment-Speicherung, Trimmen, Kappung, Leeren bei Typwechsel/Entfernen
|
|||
|
|
|
|||
|
|
Erweitert: `tests/run_whiteboard_tests.gd` (208 → 228 Assertions) prüft
|
|||
|
|
Feature-Zuweisung, Hinweis, Menüaufbau, Toggle, Undo/Redo und Leeren.
|
|||
|
|
|
|||
|
|
Visuell geprüft über `tests/manual/capture_elements.gd ... features` bei
|
|||
|
|
1400 × 876 und 1024 × 768.
|