FplCompiler

Aus StellSi-Hilfewiki
Version vom 8. August 2025, 17:36 Uhr von Mr. X (Diskussion | Beiträge) (Neue Version 0.20r100)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Dieser Artikel ist aktuell für die zukünftige Version (0.1.0.0) der Simulation.


Der StellSi-FplCompiler ist eine Alternative zum integrierten Fahrplaneditor. Es handelt sich um ein externes Programm, das die Erstellung von Netzfahrplänen vereinfachen soll.

Funktionsprinzip

Der Fahrplan wird in einem textbasierten Quellformat (.stwfq- und .stwfd-Dateien) erstellt. Der Compiler übersetzt diese Textdateien in das XML-basierte .stwf-Format von StellSi. In den Quelldateien wird der Fahrplan außenanlagen- bzw. stellwerksübergreifend definiert und der Compiler erzeugt für jedes beteiligte Stellwerk die erforderlichen .stwf-Dateien.

Durch das Funktionsprinzip bedingt können die erstellten Fahrpläne mit dem integrierten Editor zwar gelesen werden; Änderungen werden allerdings bei einer Neuübersetzung aus den Quelldaten durch den FplCompiler überschrieben.

Dokumentation

Das Quellformat wird in der mitgelieferten Bedienungsanleitung.txt beschrieben. Aktuelle Beispieldateien sind in StellSi im Ordner stellwerke/_baumaterial zu finden.

Bauempfehlungen

StellSi-Außenanlage

Der Compiler kann Betriebsstellendefinitionen und Fahrtrichtungen aus StellSi-Außenanlagen nutzen. Hierdurch können die Deklarationen in den Fahrplandaten vereinfacht werden. Der Compiler ordnet die Betriebsstellen anhand des in StellSi vergebenen DS100-Kürzels zu; das DS100-Kürzel dient als Bezeichner in den Quelldateien. Die Fahrtrichtungen werden anhand ihres Namens zugeordnet. Es wird daher empfohlen, die Außenanlagen mit Fahrtrichtungen auszurüsten, und DS100-Kürzel für Betriebsstellen zu vergeben.

Zugläufe

Der Compiler kann Zugläufe verketten (Bedienungsanleitung.txt, Kapitel 9). Um komplexe Fahrpläne schnell erstellen zu können, wird empfohlen, die Zugläufe in handhabbare Abschnitte zu zerlegen und diese dann erst bei der Benutzung individuell zu verketten. Sinnvolle Abschnittsgrenzen sind diejenigen Bahnhöfe, in denen Leistungen beginnen/enden oder Taktabweichungen entstehen.

Ein-/Ausfahrten

Es wird empfohlen, Ein- und Ausfahrten in Außenanlagen über Zuglaufsegmente (Bedienungsanleitung.txt, Kapitel 4.9) zu realisieren. Hierdurch können die eigentlichen Zugläufe deutlich verschlankt werden. Wenn mehrere Fahrmöglichkeiten zwischen benachbarten Betriebsstellen fahrplanmäßig genutzt werden sollen, können diese durch Angabe einer VzG-Strecke (Bedienungsanleitung.txt, Kapitel 4.8) differenziert werden. Dieselbe Funktion wird auch für Bildfahrpläne genutzt (Bedienungsanleitung.txt, Kapitel 4.16).

Programme

Kommandozeile

Die Kommandozeilenversion FplCompiler(.exe) nimmt den Pfad der stwfq-Datei als Parameter. Es ist unter Windows auch möglich, diese Datei per Drag&Drop auf das Programm zu ziehen. Warn- und Fehlermeldungen werden in einem Konsolenfenster dargestellt.

Bildfahrplan

Das mitgelieferte Programm Bildfahrplan(.exe) ermöglicht nicht nur eine grafische Darstellung des Fahrplans als Bildfahrplan, Gleisbelegungsplan, Umlaufplan und als tabellarischen Fahrplan, sondern ebenfalls die Übersetzung der Quelldateien. Öffnen Sie hierzu den Fahrplan (Strg+O). Mit F7 wird dieser neu geladen und übersetzt. Auftretende Warnmeldungen werden in einem zusätzlichen Fenster dargestellt. Mit F5 kann der Fahrplan neu geladen werden, ohne dass eine Übersetzung erfolgt. Das ermöglicht ein bequemes Arbeiten mit parallel geöffnetem Texteditor.

Das Programm kann mit einer laufenden StellSi-Instanz per Netzwerk verbunden werden. Hierzu muss in StellSi der Server mit aktivierter Kollege-Funktion gestartet sein. Solange die Verbindung besteht, wird die Uhrzeit im Bildfahr- und Gleisbelegungsplan dargestellt. Weitere Daten werden von StellSi derzeit nicht bereitgestellt.

Download

Aktuelle Windows-Version: 0.20r100 (Download, Windows 7 x64 oder neuer).

Aktuelle Linux-Version: Kann mit "make all" aus dem Quellcode erstellt werden. Setzt installiertes wxWidgets 3.3 und Clang voraus.

Quellcode: svn://pkeus.de/StellSi-FplCompiler