Home - topological-state/stskit GitHub Wiki

Neue Version!

Der Quelltext der neuen Version 2 ist im master-Branch aktuell verfügbar. Die Installation wurde vereinfacht, siehe Installationsseite. Ausführbare Pakete für Windows, Ubuntu und MacOS sind unter Releases verfügbar. Die Dokumentation auf diesen Seiten hinkt etwas hinterher, wird aber vorzu angepasst. Das Programm funktioniert noch nicht zu 100% wie gewünscht, sollte aber gut brauchbar sein.

Hinweis: Die neue Version benutzt ein anderes Konfigurationsschema! Die alten Dateien werden stillschweigend auf das neue Schema konvertiert. Es wird empfohlen, die alten Dateien vorher zu sichern, wenn ihr sie manuell bearbeitet habt.

STSkit / STSdispo

github-social-abstract

English

STSkit provides graphical data analysis tools such as graphical timetable, track allocation and connection matrix that help you to play Stellwerksim more efficiently. Stellwerksim is a collaborative online railroad traffic controller simulation game.

STSkit also implements a plugin client interface in Python that you can use in your own plugin development.

Main features

The main program STSdispo features the following graphical modules:

  • Graphical and textual timetables
  • Track allocation diagram
  • Entrance/Exit tables
  • Connection matrix
  • Shunting table
  • Event ticker
  • Network graph (experimental)

The project lays a focus on analyzing original schedule data, effective run times and (as low as possible) user configuration to visualize important data for efficient train disposition.

The plugin client interface exposes the complete Stellwerksim plugin interface in a Python object structure. All client-server communication is asynchronous, based on the trio library.

Like Stellwerksim, the user interface and documentation are in German.

Deutsch

Stellwerksim ist ein kollaboratives, Online-Stellwerksimulatorspiel. Das STSkit-Paket enthält verschiedene Plugins zu Stellwerksim, die dich beim Spiel unterstützen. Das Hauptprogramm STSdispo bietet eine Reihe von grafischen Werkzeugen wie Bildfahrplan, Gleisbelegung und Anschlussmatrix. Es liest die Live-Daten des laufenden Spiels aus, stellt sie grafisch dar, und unterstützt dich bei der Disposition.

STSkit enthält eine Implementierung der Stellwerksim Plugin-Schnittstelle in Python, die du auch in eigenen Projekten verwenden kannst.

Hauptmerkmale

  • Grafische und tabellarische Fahrpläne
    • Automatische Verspätungsprognose entlang der Zugketten mit Berücksichtigung der verschiedenen Betriebsvorgänge.
    • Korrekturmöglichkeiten und Erfassung von Abhängigkeiten (Anschlüsse, Kreuzungen, Überholungen)
  • Gleisbelegungsplan
    • Warnung vor Gleis- und Sektorkonflikten
    • Hervorhebung von Kupplungsvorgängen
  • Einfahrts- und Ausfahrtstabellen
    • Abschätzung der effektiven Ein- und Ausfahrtszeiten
  • Anschlussmatrix
  • Rangierplan
  • Ereignisticker
  • Asynchrone, objektorientierte Python-Schnittstelle für Stellwerksim-Plugins

Der Fokus des Projekts liegt auf der Auswertung von Fahrplandaten und der aktuellen Betriebslage, um eine möglichst reibungslose Disposition der Züge zu ermöglichen. Verspätungen werden entlang der Zugketten hochgerechnet und können vom Fdl korrigiert werden.

Entwicklungsstand

In der aktuellen Version leistet mir STSdispo bereits wertvolle Dienste beim Spielen von Stellwerksim. Das Programm hat allerdings noch einige Mängel, speziell was die Anwenderfreundlichkeit betrifft. Wer den maximalen Nutzen ziehen will, wird nicht darum herum kommen, die Konfiguration zu bearbeiten (Modul Einstellungen). Ich hoffe trotzdem, dass das Programm nützlich ist und bitte um Nachsicht und Geduld, wenn nicht alles reibungslos funktioniert.

Als Alleinentwickler kann ich leider keine Garantien abgeben und nicht auf alle individuellen Problemfälle eingehen. Helft euch bitte auch untereinander, in den Discussions, im STS-Forum oder im STS-Chat. Offensichtliche Fehler könnt ihr unter Issues melden, Wünsche und Nomenklaturprobleme (ich arbeite nicht bei der Bahn und kenne nicht alle Begriffe) in den Discussions.

Grundlegende Probleme

  • Die Plugin-Schnittstelle vom Stellwerk-Sim gibt nur Gleise an, keine Bahnhöfe. Die Zuordnung von Gleisen zu Bahnhöfen ist daher in vielen Stellwerken fehlerhaft und muss von Hand korrigiert werden (im Modul Einstellungen).
  • Die Streckenberechnung ist in einigen Stellwerken fehlerhaft, z.B. bei Haltepunkten oder Umfahrungen.

Mitarbeit

  • Erfahrene Python-, Matplotlib- und Qt-Entwickler dürfen gerne beitragen.
  • Community-Hosting von Konfigurationsdateien.