- Katalog und Level-Regeln mit Saison und Quelle im Dialogkopf - Zusammenfassung zaehlt die geprueften Elemente - Tooltip am Pruefen-Button nennt die Saisons - Whiteboard-Tests auf 237 Assertions erweitert (870 gesamt)
8.5 KiB
ISU-Regelwerk – Elementkatalog und Level-Features
Stand: 2026-10-31 Saison: 2025/26
Quellen:
- ISU Communication No. 2707, Single & Pair Skating – Scale of Values valid as of July 1, 2025 (ersetzt Communication 2656)
- 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)
Zweck
Der Katalog liefert die Base Values (BV) zu Elementkürzeln und Leveln. Er ist bewusst reine Daten und vom Whiteboard entkoppelt: Eine neue Saison ersetzt eine JSON-Datei, nicht den Modell- oder Controller-Code.
Aktuell abgedeckt:
- 24 Sprünge von
1Tbis4A - 16 Pirouettenfamilien der Einzel- und Paarlauf-SoV (einpositionig, mit Fußwechsel, Kombinationen, jeweils auch geflogen)
- 2 Sequenzen:
StSq(Base–4) undChSq(nur Level 1) - Level-Features für Pirouetten (14) und Schrittsequenzen (4) inklusive Level-Berechnung nach Feature-Anzahl
Nicht abgedeckt (bewusst offen): GOE-Tabellen, reduzierte V-Varianten,
Unterrotations-/Fehlkanten-Suffixe (<, <<, q, e, !), Sprungkombinationen
und -folgen, Paarlauf-Hebungen/Twists/Throws sowie Eistanz-Elemente.
Dateien
| Datei | Inhalt |
|---|---|
rinkplanner/src/core/rules/data/isu_sov_2025_26.json |
Katalog mit Base Values |
rinkplanner/src/core/rules/data/isu_levels_2025_26.json |
Level-Features und Schwellen |
rinkplanner/src/core/rules/element_catalog.gd |
Laden, Lookup, Vorschläge, Prüfung |
rinkplanner/src/core/rules/element_definition.gd |
eine Elementfamilie mit BV je Level |
rinkplanner/src/core/rules/element_level_rules.gd |
Feature-Lookup und Level-Berechnung |
rinkplanner/src/core/rules/element_feature.gd |
ein Level-Feature mit Zählgrenzen |
rinkplanner/tests/run_rules_tests.gd |
Katalog-Tests inkl. Stichproben |
rinkplanner/tests/run_level_tests.gd |
Feature- und Level-Tests |
Datenformat
{
"schema_version": 1,
"season": "2025/26",
"discipline": "Single & Pair Skating",
"valid_from": "2025-07-01",
"source": "ISU Communication No. 2707, ...",
"elements": [
{
"code": "3Lz",
"name": "Triple Lutz",
"type": "jump",
"base_value": 5.90
},
{
"code": "CCoSp",
"name": "Change foot combination spin",
"type": "spin",
"base_values": {
"B": 1.70, "1": 2.00, "2": 2.50, "3": 3.00, "4": 3.50
}
}
]
}
codeist die Familie ohne Level-Suffix (3Lz,CCoSp,StSq).typeistjump,spinodersequenceund wird aufPathSegment.ElementTypeabgebildet.- Sprünge haben genau einen
base_value(Level 0). Pirouetten und Sequenzen nutzenbase_valuesmit"B"für Base und"1"–"4"für die Level. - Werte sind Dezimalzahlen mit Punkt; die UI zeigt sie mit Komma.
Lookup-Regeln
ElementCatalog bietet:
var catalog := ElementCatalog.load_default()
catalog.find("CCoSp") # ElementDefinition oder null
catalog.get_base_value("CCoSp", 4) # 3.50
catalog.get_base_value("CCoSp4", -1) # 3.50 (Level aus Suffix)
catalog.get_base_value("3Lz", 2) # 5.90 (Sprunglevel wird ignoriert)
catalog.get_base_value("3X") # -1.0
catalog.get_segment_base_value(segment) # BV eines getaggten Segments
catalog.suggest(PathSegment.ElementType.SPIN, "ccosp", 8)
- Lookup ist getrimmt und case-insensitiv.
- Kanonische Codes mit Suffix (
CCoSp4,StSqB) werden akzeptiert; ein Suffix im Kürzel hat Vorrang vor der Level-Auswahl. - Der Controller trennt beim Übernehmen ein Level-Suffix vom Kürzel ab und
setzt das Level-Feld. Gespeichert wird immer die Familie, z. B.
CCoSp+ Level 4 stattCCoSp4+ Level 3. - Unbekannte Kürzel, falsche Typen und nicht vorhandene Level liefern
-1.0statt eines stillen Defaults. - Existiert ein Element nur auf einem Level (
ChSq1), löst ein bloßesChSqauf dieses eine Level auf. - Der Base Value wird nicht am Segment gespeichert. Das Segment trägt nur
element_codeundelement_level; die Anzeige fragt den Katalog.
Level-Features
Die Level-Regeln stehen in einer eigenen JSON-Datei, weil sie aus einer anderen ISU-Communication stammen und sich unabhängig von den Base Values ändern können. Pro Elementtyp gibt es Feature-Definitionen, Pflichtfeatures und – bei Pirouetten – die Menge der Features, von denen mindestens eines für Level 4 nötig ist.
| Elementtyp | Features | Besonderheit |
|---|---|---|
| Pirouette | 14 | Max. 2 schwierige Variationen pro Pirouette; Level 4 verlangt eines von 6 bestimmten Features |
| Schrittsequenz | 4 | Feature 1 (Vielfalt) ist Pflicht; ohne sie bleibt die Sequenz Base |
ChSq |
– | Fest Level 1 |
| Sprung | – | Nicht levelbar |
Die Schwelle ist für beide Typen gleich: 1 Feature → Level 1, 2 → Level 2,
3 → Level 3, 4 oder mehr → Level 4. Ohne Feature bleibt das Element Base.
ElementLevelRules.calculate_level() liefert neben dem Level auch die
gezählten, ignorierten und fehlenden Pflichtfeatures:
var rules := ElementLevelRules.load_default()
var result := rules.calculate_level(
PathSegment.ElementType.SPIN,
"CCoSp",
PackedStringArray(["difficult_variation", "difficult_exit"])
)
# result.level == 2, result.counted_features == 2
Das Segment speichert die Auswahl als element_features
(PackedStringArray). Duplikate sind erlaubt, damit zwei schwierige
Variationen als zwei Features zählen. Die Daten enthalten außerdem
once_per_program (Feature zählt nur beim ersten Versuch im Programm) und
max_per_element. Die Programmprüfung und die Begrenzung „max. zwei Features
pro Fuß“ sind noch nicht umgesetzt.
Bedienung
Der Element-Inspector zeigt unter der Level-Auswahl Base Value: 3,50.
Unbekannte Kürzel erscheinen als „Kürzel nicht im Katalog 2025/26“. Der
Hinweis aktualisiert sich bei Änderungen an Typ, Kürzel und Level; der Tooltip
nennt Saison und Quelle.
Darunter liegt der Button Features (n). Er öffnet eine Checkbox-Liste mit
den Features des Elementtyps; die Auswahl wird beim Schließen übernommen und
ist undo-fähig. Ein Hinweis zeigt die gezählten Features, das daraus
abgeleitete Level und – bei Abweichung – das manuell gewählte Level, z. B.
Features: 2 · Level 2 · gewählt: Level 4. Das gewählte Level bleibt
autoritativ; die Feature-Prüfung ersetzt es nicht stillschweigend.
Prüfung
RoutineValidator prüft alle Elementsegmente gegen Katalog und Level-Regeln
und liefert ValidationIssue-Befunde mit Schweregrad, Meldung und Bezug zu
Abschnitt und Segment. Geprüft werden:
- unbekannte Kürzel und Kürzel mit falschem Elementtyp
- nicht verfügbare Level, Sprung-Level ungleich 0 und das feste Level von
ChSq - unbekannte Features, zu häufige Features und fehlende Pflichtfeatures
- Abweichungen zwischen Feature-Ergebnis und gewähltem Level
- Features, die laut Daten nur einmal pro Programm zählen
Der Button Prüfen in der Statusleiste öffnet die Befunde in einem Dialog. Der Dialog nennt zuerst Katalog und Level-Regeln mit Saison und Quelle sowie die Anzahl der geprüften Elemente. Die Prüfung blockiert Speichern und Export nicht. Noch nicht geprüft werden Programmtyp, erlaubte Elementanzahl, Wiederholungs- und Kombinationsregeln sowie die Begrenzung auf zwei Features pro Fuß.
Neue Saison einpflegen
- Neue ISU-Communication (Scale of Values) beschaffen und als JSON nach dem
obigen Schema anlegen, z. B.
isu_sov_2026_27.json. season,valid_fromundsourceaktualisieren.ElementCatalog.DEFAULT_PATHauf die neue Datei zeigen lassen.- Stichproben in
tests/run_rules_tests.gdauf die neuen Werte anpassen (mindestens ein Sprung, eine Pirouette, eine Sequenz). - Neue Level-Communication (Levels of Difficulty) als
isu_levels_2026_27.jsonanlegen,ElementLevelRules.DEFAULT_PATHumstellen undtests/run_level_tests.gdanpassen. ./tools/test.shausführen.- Die alte Datei kann für Nachvollziehbarkeit im Repo bleiben; aktiv ist immer genau eine Datei pro Regelart.
Die JSON-Dateien werden über include_filter="*.json" in allen Export-Presets
mit ausgeliefert.
Nächste Ausbaustufen
- Max. zwei Features pro Fuß und Feature-Positionsregeln
- Programmtypen, erlaubte Elementanzahl sowie Wiederholungs- und Kombinationsregeln
- GOE-Tabellen und
V-/Unterrotations-Varianten - Sprungkombinationen und -folgen als zusammengesetzte Elemente
- Adult-spezifische Programmregeln
- Vorschlagsliste im Inspector direkt aus
suggest()