Programm für die Vereinsmeisterschaften der Schwimmabteilung des TSV Illertissen. Folgende Funktionen sind enthalten:
- Verwaltung von Meldungen
- Verwaltung von Wettkämpfen
- Automatische oder manuelle Erstellung von Rennabläufen
- Eingabe der erschwommenen Zeiten
- Auswertung der Ergebnisse
- Erstellung von Dokumenten (Startlisten, Urkunden, Ergebnislisten, ...)
Die Software benötigt keine Installation im klassischen Sinne. Es muss lediglich die .exe Datei entpackt werden.
- Aktuellstes Release herunterladen.
- Die heruntergeladene .zip Datei an einen beliebigen Ort entpacken.
- Die Datei
Vereinsmeisterschaften.exeim entpackten Ordner ausführen. - Nach dem ersten Start einen Arbeitsbereich auswählen oder einen neuen Ordner anlegen und dann auswählen.
Sollte die Software nicht starten, könnte eine Runtime Version fehlen. Dann folgenden Runtime Installer herunterladen und installieren: .NET Desktop Runtime 10.0.1 Installer Anschließend sollte die Software starten.
Nachfolgend werden kurz die Funktionen der jeweiligen Seite der Anwendung beschrieben. Die Reihenfolge der Seiten spiegelt ungefähr den gesamten Workflow wieder (von der Eingabe der Meldungen, über die Eingabe der Zeiten während des Wettkampfs bis zur Auswertung).
Startseite, von der auf alle anderen Bereiche zugegriffen werden kann. Gleichwertig mit dem Menü am linken Rand.
Hier kann der aktuelle Ordner des Arbeitsbereichs (mehr Details siehe unten) ausgewählt und alle Änderungen gespeichert werden (standardmäßig eingeklappt, sobald ein Arbeitsbereich offen ist). Außerdem können alle Einstellungen für verschiedene Aspekte der Software hier getroffen und auch wieder zurückgesetzt werden.
Es gibt außerdem einen alternative Ansicht, mit der von überall aus der aktuelle Arbeitsbereich gespeichert oder gewechselt werden kann (diese ist über die Titelleiste neben dem Zurück-Knopf zugänglich).
Hier werden alle verfügbaren Wettkämpfe und Regel für die zugeordneten Wettkampf Strecken definiert. Ein Wettkampf wird beschrieben über die Lage, die Strecke, das Alter und eine entsprechende Zeit. Die Zeit wird dann für die Berechnung der Punkte her genommen. Wird exakt die hier eingetragene Zeit erschwommen, gibt es 100 Punkte. Wenn langsamer gibt es weniger Punkte, wenn schneller dann mehr. Die Strecke eines Wettkampfs wird über die die Wettkampf Distanz Regeln festgelegt. Die erste passende Regel wird verwendet. Für jeden Start einer Person muss auch ein entsprechender Wettkampf verfügbar sein.
Außerdem können hier auch die Wettkämpfe automatisch aus der Rudolph Tabelle erstellt werden (enthält für verschiedene Alter, Stile und Strecken entsprechende Vorgabezeiten). Es werden nur Wettkämpfe erzeugt, für die auch Wettkampf Distanz Regeln vorhanden sind.
Hier können alle Meldungen eingetragen werden. Für die Meldung ist der Name, der Jahrgang und die gewünschten Lagen nötig. Für jede Lage muss auch ein entsprechender Wettkampf hinterlegt sein! Sonst wird der Start ignoriert (wird hier auch farblich markiert).
Hier kann eine Reihenfolge für die Starts erstellt werden. Entweder manuell per Hand (Variante hinzufügen und die Starts per Hand vom rechten Bereich in die Mitte ziehen) oder automatisch (es werden zufällig Varianten erstellt und nach verschiedenen Kriterien bewertet).
Jede Variante eines Rennens wird von 0% (schlecht) bis 100% (perfekt) bewertet. Im Arbeitsbereich kann die Gewichtung oder verschiedene Parameter für die automatische Berechnung eingestellt werden.
Es gibt auch die Möglichkeit, bestimmte Starts hervorzuheben. Z.B. alle Starts einer Person um zu schauen, ob genügend Pausen vorhanden sind.
Für jeden Start kann hier die erschwommene Zeit eingetragen werden (in Minute, Sekunden und Zehntelsekunden). Es stehen verschiedene Filtermöglichkeiten zur Verfügung.
Hier wird die Auswertung aus allen Starts angezeigt (wie viele Punkte die jeweils erschwommenen Zeiten ergeben). Es ist möglich, auch die besten Schwimmer in einer bestimmten Lage zu ermitteln.
Hier können verschiedene Dokumente erstellt werden, die vor, während oder nach dem Wettkampf nötig sind.
Außerdem ist eine Übersicht über alle verfügbaren Platzhalter vorhanden, die in den Dokumenten verwendet werden können.
Mehr Details sind im Kapitel Dokumenten Templates zu finden.
Auf dieser Seite werden verschiedene Analysen dargestellt. Diese Analysen hängen von verschiedenen Daten ab, die auf den anderen Seiten eingegeben wurden. Infos zu den einzelnen Analysen:
- Anzahl Personen: Analysieren, wie viele Personen gemeldet sind (aktiv und inaktiv).
- Geschlechterverteilung der aktiven Personen: Analysieren, wie viel Prozent der Personen männlich bzw. weiblich sind. Nur aktive Personen werden gezählt.
- Anzahl Starts: Analysieren, wie viele Starts gemeldet sind (aktiv und inaktiv).
- Geschlechterverteilung der gültigen Starts: Analysieren, wie viel Prozent der Starts männlich bzw. weiblich sind. Nur gültige Starts werden gezählt (aktiv und mit zugewiesenem Wettkampf).
- Anzahl von gültigen Starts pro Stil: Analysieren, wie viele Starts pro Schwimmstil gemeldet sind. Nur gültige Starts werden gezählt (aktiv und mit zugewiesenem Wettkampf).
- Anzahl von gültigen Starts pro Distanz: Analysieren, wie viele Starts pro Distanz gemeldet sind. Nur gültige Starts werden gezählt (aktiv und mit zugewiesenem Wettkampf).
- Anzahl Personen pro Geburtsjahr: Analysieren, wie viele Personen pro Geburtsjahr gestartet sind. Nur aktive Personen werden gezählt.
- Anzahl an gültigen Starts pro Person: Analysieren, wie viele Starts jede Person hat. Nur gültige Starts werden gezählt (aktiv und mit zugewiesenem Wettkampf).
- Abstände zwischen den Starts einer Person: Analysieren, wie viel Pause zwischen den Starts einer Person ist. Nur aktive Starts werden gezählt.
- Geburtsjahr je Platz im Gesamtergebnis: Analysieren, welches Geburtsjahr für jeden Platz im Gesamtergebnis zugeordnet ist.
- Geburtsjahre je Rennen: Analysieren, welche Geburtsjahre je Rennen antreten.
Hier kann das Software Design verändert werden. Hell, Dunkel oder Systemeinstellung stehen zur Verfügung.
Der Arbeitsbereich ist ein Ordner, in dem alle Einstellungen, Wettkämpfe und Meldungen gespeichert werden. Hier bietet es sich an, für jeden Wettkampf (z.B. jedes Jahr) einen neuen Ordner anzulegen. Es ist egal, wo sich der Ordner auf der Festplatte befindet.
Folgende Dateien werden erzeugt:
- WorkspaceSettings.json: JSON Datei mit allen Einstellungen für den Arbeitsbereich. Dieser Dateiname ist fix.
- Personen.csv / Person.csv: Liste mit allen Meldungen und den erschwommenen Zeiten.
- Wettkaempfe.csv / Competitions.csv: Liste mit allen verfügbaren Wettkämpfen.
- WettkampfDistanzRegeln.csv / CompetitionDistanceRules.csv: Liste mit allen verfügbaren Regeln für die Wettkampf Distanzen.
- BestesRennen.csv / BestRace.csv: Das Rennen, das als gute Variante markiert wurde, wird hier gespeichert. Wenn kein Rennen markiert wurde, existiert diese Datei nicht.
Die Dateinamen werden folgendermaßen ermittelt:
- Beim Laden des Arbeitsbereichs wird die Datei der aktuellen Systemsprache verwendet (wenn verfügbar). Wenn nicht verfügbar, wird die neueste Datei aus allen verfügbaren Sprachen (momentan Deutsch und Englisch) verwendet.
- Beim Speichern des Arbeitsbereichs wird immer die aktuelle Systemsprache verwendet. Sollte der Arbeitsbereich mit einer Datei einer anderen Sprache geladen worden sein, wird die alte Datei gelöscht und die neue Datei in Systemsprache abgespeichert.
Bei den Datei-Inhalten gilt die gleiche Logik wie beim Dateinamen. Beim Laden wird z.B. "Brust" und "Breaststroke" beim Stil unterstützt. Beim Abspeichern wird z.B. immer "Brust" geschrieben, wenn die Systemsprache Deutsch ist.
Es können hier natürlich weitere Dateien abgelegt werden (z.B. Templates).
Die Punkte eines Starts werden folgendermaßen berechnet:
- Folgende Formel wird verwendet:
Punkte = (2 - (ErschwommeneZeit / WettkampfVorgabeZeit)) * 100; - Wird exakt die Zeit des hinterlegten Wettkampfs erschwommen (ErschwommeneZeit == WettkampfVorgabeZeit), gibt es 100 Punkte.
- Wenn langsamer dann gibt es weniger Punkte.
- Wenn schneller dann gibt es mehr Punkte.
- Null Punkte, sobald
ErschwommeneZeit >= 2 * WettkampfVorgabeZeit
Der Start mit der höchsten Punktezahl wird als "Bestes Rennen" gewertet und für die Gesamtwertung herangezogen. Es wird kein Durchschnitt gebildet.
Bei der Erstellung von Dokumenten werden Template Dateien verwendet, die als Vorlage für das spätere Dokument verwendet werden. Bei den Templates handelt es sich um gewöhnliche .docx Dateien, die z.B. in Microsoft Word oder Libre Office erstellt werden können. Diese Dateien legen die Struktur und das Aussehen für die späteren Ausgabedokumente fest. Daten aus der Vereinsmeisterschaften Software können über Platzhalter eingefügt werden. Platzhalter werden dabei über bestimmte Zeichen (über die Arbeitsbereich Einstellungen konfigurierbar) gekennzeichnet, die vor und nach dem Platzhalternamen stehen (z.B. "%Name%", wobei "%" der Platzhalter Marker ist).
Auf der Seite Dokumente erstellen ist eine Tabelle verfügbar, die alle verfügbaren Platzhalter auflistet. Nicht jeder Platzhalter kann in jedem Dokumententyp verwendet werden. Das wird auch in der Tabelle aufgeschlüsselt.
Die Platzhalter können entweder direkt im Text oder in Tabellen verwendet werden:
- Text: Textplatzhalter werden an ihrer jeweiligen Stelle im Dokument einfach ersetzt. Die Ersetzungsdaten werden anhand des Platzhalternamens bestimmt.
- Tabelle: Tabellenplatzhalter müssen sich innerhalb einer Tabelle des Dokuments befinden. Alle Tabellen im Dokument, die mindestens einen unterstützten Platzhalter enthalten, werden verarbeitet. Die erste Zeile mit einem Platzhalter dient als Vorlage für die neuen Zeilen. Für jedes Datenelement wird eine neue Zeile erstellt (z.B. eine neue Zeile je Person). Die Ersetzungsdaten werden durch den Platzhalternamen bestimmt.
Je nach Dokumententyp werden entweder Text- oder Tabellenplatzhalter unterstützt. Das wird auf der Seite Dokumente erstellen unter dem jeweiligen Button zum Erstellen des Dokuments mit Icons dargestellt.
Je nach Dokumententyp wird entweder eine Seite oder mehrere Seiten erstellt. Das wird auf der Seite Dokumente erstellen unter dem jeweiligen Button zum Erstellen des Dokuments mit Icons dargestellt.
- Eine Seite: Es wird nur eine Seite für die Daten dieses Dokumententyps erstellt (bzw. falls der Inhalt zu lang wird, gibt es mehrere Seiten). Z.B. wird aus einer Liste an Personen eine Seite mit einer Tabelle mit allen Personen erzeugt ("Übersichtsliste erstellen").
- Mehrere Seiten: Es werden mehrere Seite für die Daten dieses Dokumententyps erstellt (eine Seite pro Datenelement, z.B. eine Seite pro Person). Z.B. wird aus einer Liste an Personen je eine Seite pro Person erzeugt ("Urkunden erstellen").
In den Arbeitsbereich Einstellungen kann konfiguriert werden, dass neben dem .docx Ausgabedokumente auch ein .pdf erstellt werden soll. Für die Umwandlung gibt es momentan folgende unterstützte Programme:
- Word (Microsoft Office Word): muss auf dem PC installiert sein.
- Libre Office: muss auf dem PC installiert sein.
Welches Programm zur Umwandlung verwendet wird, wird folgendermaßen bestimmt:
- Es wird bestimmt, mit welchem Programm das Template .docx erstellt wurde. Ist das ermittelte Programm installiert, wird es auch zur Umwandlung verwendet (z.B. Template mit Word erstellt und Word installiert -> Word verwenden).
- Ist das ermittelte Programm nicht installiert, wird das nächste installierte Programm verwendet (z.B. Template mit Word erstellt, Word NICHT installiert, Libre Office installiert -> Libre Office verwenden).
- Gibt es einen Fehler bei der Umwandlung, wird auch das nächste installierte Programm probiert.
- Wurde kein passendes Programm gefunden oder gab es einen Fehler bei der Umwandlung, wird eine Fehlermeldung angezeigt.
Jeder Start einer Person muss einem Wettkampf zugeordnet werden. Dies geschieht abhängig vom gewählten Modus. Folgendes Diagramm zeigt exemplarisch die Zuordnung für Brust Starts (Wasserflöhe werden immer dem ersten gefundenen Wasserfloh-Wettkampf zugeordnet):
flowchart LR
subgraph Wettkämpfe
C18f["♀ Brust 18J."]
C18m["♂ Brust 18J."]
C17f["♀ Brust 17J."]
C17m["♂ Brust 17J."]
C16f["♀ Brust 16J."]
C16m["♂ Brust 16J."]
C15f["♀ Brust 15J."]
C15m["♂ Brust 15J."]
C14f["♀ Brust 14J."]
C14m["♂ Brust 14J."]
C13f["♀ Brust 13J."]
C13m["♂ Brust 13J."]
Gap["Fehlende Wettkämpfe"]
C9f["♀ Brust 9J."]
C9m["♂ Brust 9J."]
C8f["♀ Brust 8J."]
C8m["♂ Brust 8J."]
C7f["♀ Brust 7J."]
C7m["♂ Brust 7J."]
C6f["♀ Wasserfloh 6J."]
C6m["♂ Wasserfloh 6J."]
end
subgraph Legende
direction TB
L1["🟡① Nur genaues Alter"]
L2["🔴② Genaues oder nächst niedrigeres Alter"]
L3["🟢③ Genaues oder nächst höheres Alter"]
L4["🔵④ Genaues Alter oder max. Alter wenn die Person älter ist"]
L5["⚫⑤ Genaues Alter oder nächstgelegenes Alter (niedrigeres Alter bevorzugen bei gleichem Abstand)"]
L6["⚪⑥ Genaues Alter oder nächstgelegenes Alter (höheres Alter bevorzugen bei gleichem Abstand)"]
end
P19f["👤 ♀ 19J."]
P18m["👤 ♂ 18J."]
P15f["👤 ♀ 15J."]
P12m["👤 ♂ 12J."]
P11m["👤 ♂ 11J."]
P8f["👤 ♀ 8J."]
P5m["👤 ♂ 5J."]
P19f -- "🔴② 🔵④ ⚫⑤ ⚪⑥" --> C18f
P18m -- "🟡① 🔴② 🟢③ 🔵④ ⚫⑤ ⚪⑥" --> C18m
P15f -- "🟡① 🔴② 🟢③ 🔵④ ⚫⑤ ⚪⑥" --> C15f
P12m -- "🟢③ ⚫⑤ ⚪⑥" --> C13f
P12m -- "🔴②" --> C9f
P11m -- "🟢③ ⚪⑥" --> C13f
P11m -- "🔴② ⚫⑤" --> C9f
P8f -- "🟡① 🔴② 🟢③ 🔵④ ⚫⑤ ⚪⑥" --> C8m
P5m -- "🟡① 🔴② 🟢③ 🔵④" --> C6m
Detailliertere Entwickler Dokumentation: https://m1s2.github.io/Vereinsmeisterschaften
- SwimmingStyles.png: https://www.vecteezy.com/vector-art/349116-swimming-aqua-aquatic-sport-game-icon-symbol-sign-pictogram
- icons8-child-64.png: https://icons8.com/icon/67246/babys-room
- Geometry_Female: https://pictogrammers.com/library/mdi/icon/gender-female/
- Geometry_Male: https://pictogrammers.com/library/mdi/icon/gender-male/
- Geometry_DecimalComma: https://pictogrammers.com/library/mdi/icon/decimal-comma/
- Geometry_Counter: https://pictogrammers.com/library/mdi/icon/counter/
- Geometry_Weight: https://pictogrammers.com/library/mdi/icon/weight/
- Geometry_Priority: https://pictogrammers.com/library/mdi/icon/priority-high/
- Geometry_Trophy: https://pictogrammers.com/library/mdi/icon/trophy-outline/_
- Geometry_AccountTie: https://pictogrammers.com/library/mdi/icon/account-tie/
https://retouchinglabs.com/inkscape-convert-png-to-svg/ https://stackoverflow.com/questions/18624070/convert-svg-to-xaml