Handbuch

STS Handbuch

Stellwerksim Handbuch

Webseiten-Werkzeuge

Sie befinden sich hier: StellwerkSIM » StellwerkSIM » Das Erbauerhandbuch » Zugbau » Zugscript
Zuletzt angesehen: • StiTz • Zugscript
stellwerksim:erbauer:zugbau:zugscript

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung		Vorhergehende Überarbeitung
stellwerksim:erbauer:zugbau:zugscript [2019/01/19 18:25] – DevonFroschstellwerksim:erbauer:zugbau:zugscript [2026/05/23 20:54] (aktuell) – Doku für neue Tools in Zugscript-Editor DevonFrosch
Zeile 1: Zeile 1:
 {{indexmenu_n>20}} {{indexmenu_n>20}}
-==== Zugscript ====+===== Zugscript =====
  
 Zugscripte (kurz ZS) werden mit dem Takt-Befehl geschrieben. Jeder Befehl bekommt eine eigene Zeile, am Schluss jeder Zeile muss ein Semikolon gesetzt werden. Zugscripte (kurz ZS) werden mit dem Takt-Befehl geschrieben. Jeder Befehl bekommt eine eigene Zeile, am Schluss jeder Zeile muss ein Semikolon gesetzt werden.
Zeile 9: Zeile 9:
 Der <Takt in Minuten> muss immer als erstes im Befehl stehen und einen Mindestwert von 1 haben. Auf keinen Fall darf der <Takt in Minuten> weg gelassen werden. Sollte es sich nur um eine Einzelfahrt handeln, so ist der Wert 60 oder ähnliches einzugeben. Der <Takt in Minuten> muss immer als erstes im Befehl stehen und einen Mindestwert von 1 haben. Auf keinen Fall darf der <Takt in Minuten> weg gelassen werden. Sollte es sich nur um eine Einzelfahrt handeln, so ist der Wert 60 oder ähnliches einzugeben.
  
-Das Word ''takt'' muss immer klein, die Befehle innerhalb der Klammern immer groß geschrieben werden. Alle anderen Schreibweisen funktionieren höchstens zufällig und werden nicht unterstützt.+Das Wort ''takt'' muss immer klein, die Befehle innerhalb der Klammern immer groß geschrieben werden. Alle anderen Schreibweisen funktionieren höchstens zufällig und werden nicht unterstützt.
  
 Die weiteren Parameter werden dabei im Format "Befehl=Zuweisung" angegeben. Einzelne Parameter werden voneinander mit einem Komma getrennt und können in beliebiger Reihenfolge angegeben werden. Die weiteren Parameter werden dabei im Format "Befehl=Zuweisung" angegeben. Einzelne Parameter werden voneinander mit einem Komma getrennt und können in beliebiger Reihenfolge angegeben werden.
  
-^ Befehl ^ Zuweisung ^ Bemerkung ^ Pflichtangabe ^ +^ Befehl ^ Zuweisung ^ Bemerkung ^ Pflichtangabe ^ Anzahl pro Zugscript ^ 
-| ID | Referenz-AID | AID des Referenz-Stellwerks (in welchem die Zeiten des Script gelten) angegeben | Ja | +| [[#referenzbahnsteig_id_und_gleis|ID]] | Referenz-AID | AID des Referenz-Stellwerks (in welchem die Zeiten des Script gelten) angegeben | Ja | Genau einmal | 
-| GLEIS | Referenzbahnsteig | Name des Referenz-Bahnsteiges | Ja | +| [[#referenzbahnsteig_id_und_gleis|GLEIS]] | Referenzbahnsteig | Name des Referenz-Bahnsteiges | Ja | Genau einmal | 
-| STUNDE | hh oder hh..hh | Fährt der Zug nur in einer Stunde wird diese eingetragen. Fährt der Zug mehrere Stunden wird die erste Stunde in der der Zug fährt und nach zwei Punkten die erste Stunde in der der Zug nicht mehr fährt eingetragen | Ja, mindestens eins, beliebig viele | +| [[#abfahrtszeit_stunde_und_milzeit|STUNDE]] | std1 oder std1..std2 | std1 = Stunde der ersten Abfahrt, std2 = Stunde __vor__ der letzten Abfahrt | Ja | Mindestens einmal, beliebig viele, auch gemischt | 
-| MILZEIT | hhmm oder hhmm..hhmm | Die Milzeit wird im Format stdmin angegeben (kein Leerzeichen oder Doppelpunkt zwischen Stunde und Minute). Fährt der Zug nur einmal wird die Milzeit eingetragen. Fährt der Zug mehrmals wird die erste Milzeit in der der Zug fährt und nach zwei Punkten die erste Milzeit in der der Zug nicht mehr fährt eingetragen | ::: | +| [[#abfahrtszeit_stunde_und_milzeit|MILZEIT]] | stdmin1 oder stdmin1..stdmin2 | stdmin1 = Stunde und Minute der ersten Abfahrt, stdmin2 = Stunde und Minute __vor__ der letzten Abfahrt | ::: | ::: | 
-| MULTI | Referenz Flag | Wird wird das Multiflag eingetragen welches in den durch diese Scriptzeile erzeugten Züge verwendet wird | Nein | +| [[#mehrfache_verknuepfungen_multi|MULTI]] | Referenz-Flag | Wird das Multiflag eingetragen welches in den durch diese Scriptzeile erzeugten Züge verwendet wird | Nein | Höchstens zweimal (1x für [[stellwerksim:erbauer:zugbau:flags:f-flag|F-Flag]], 1x für [[stellwerksim:erbauer:zugbau:flags:k-flag|K-Flag]] oder [[stellwerksim:erbauer:zugbau:flags:e-flag|E-Flag]]) | 
-| NAME | [[stellwerksim:erbauer:zugbau:namensmuster|Namensmuster]] | Wird im Feld Namensmuster kein [[stellwerksim:erbauer:zugbau:namensmuster|Namensmuster]] eingebaut muss dieses hier angegeben werden. Die entsprechenden Regeln werden auf der [[stellwerksim:erbauer:zugbau:namensmuster|Namensmuster]]-Seite beschrieben | Nein |+| [[#themamarker_marker|MARKER]] | Ein Großbuchstabe | Nur Fahrplaneinträge mit diesem Themamarker werden für den Zug übernommen | Nein | Höchstens einmal | 
 +| [[#namensmuster_im_zugscript_name|NAME]] | [[stellwerksim:erbauer:zugbau:namensmuster|Namensmuster]] | Wenn vorhanden, muss der Parameter in jedem Zugscript vorhanden und das Namensmuster-Feld des Zugtemplates leer sein. | Nein | Höchstens einmal |
  
 <note warnung>Der im Zugscript angegebene Referenzbahnsteig darf nur einmal als Fahrplaneintrag enthalten sein!</note> <note warnung>Der im Zugscript angegebene Referenzbahnsteig darf nur einmal als Fahrplaneintrag enthalten sein!</note>
 <note hinweis>Das Zugscript darf nicht aus der Historie oder einem Textverarbeitungsprogramm wie Word kopiert werden! Ansonsten kann es sein, dass das Zugscript in mehrere Teile zerrissen wird, da hier nicht sichtbare Zeichen mitkopiert werden.</note> <note hinweis>Das Zugscript darf nicht aus der Historie oder einem Textverarbeitungsprogramm wie Word kopiert werden! Ansonsten kann es sein, dass das Zugscript in mehrere Teile zerrissen wird, da hier nicht sichtbare Zeichen mitkopiert werden.</note>
-===== Referenzbahnsteig (ID und GLEIS) =====+ 
 +==== Referenzbahnsteig (ID und GLEIS) ====
  
 Der Referenzbahnsteig wird genutzt, um die Fahrplanzeile festzulegen, auf die sich die STUNDE bzw. MILZEIT beziehen. Angegeben wird hier die Anlagen-ID (in ID) und der Name des Bahnsteig- bzw. Haltepunktelements. Die Schreibweise muss dabei genau so wie im Fahrplan sein. Der Referenzbahnsteig wird genutzt, um die Fahrplanzeile festzulegen, auf die sich die STUNDE bzw. MILZEIT beziehen. Angegeben wird hier die Anlagen-ID (in ID) und der Name des Bahnsteig- bzw. Haltepunktelements. Die Schreibweise muss dabei genau so wie im Fahrplan sein.
Zeile 29: Zeile 31:
 Der Referenzbahnsteig darf nicht mehrfach im Fahrplan vorkommen, außer an im jeweiligen Zugscript nicht genutzten MULTI-Zeilen. Der Referenzbahnsteig darf nicht mehrfach im Fahrplan vorkommen, außer an im jeweiligen Zugscript nicht genutzten MULTI-Zeilen.
  
-Beispiel: +== Beispiel ==
-^ an ^ ab ^ AID ^Gleis ^ Flag ^ +
-| 05:00 | 05:00 | 123 | A1 | E1(1234) | +
-| 05:00 | 05:00 | 123 | A1 | E2(4321) | +
 Zugscript: Zugscript:
   takt(60,ID=123,GLEIS=A1,STUNDE=5,MULTI=E1);   takt(60,ID=123,GLEIS=A1,STUNDE=5,MULTI=E1);
   takt(60,ID=123,GLEIS=A1,STUNDE=6,MULTI=E2);   takt(60,ID=123,GLEIS=A1,STUNDE=6,MULTI=E2);
 +
 +Fahrplan:
 +^ an ^ ab ^ AID ^Gleis ^ Flag ^
 +| 05:00 | 05:00 | 123 | A1 | E1(1234) |
 +| 05:00 | 05:00 | 123 | A1 | E2(4321) |
  
 Hier darf Gleis A1 als Referenzbahnsteig verwendet werden, weil es zusammen mit dem MULTI eindeutig ist (die andere Zeile wird entfernt). Das Gleis A1 darf dann aber außerhalb der MULTI-Verknüpfung nicht auftreten. Hier darf Gleis A1 als Referenzbahnsteig verwendet werden, weil es zusammen mit dem MULTI eindeutig ist (die andere Zeile wird entfernt). Das Gleis A1 darf dann aber außerhalb der MULTI-Verknüpfung nicht auftreten.
Zeile 42: Zeile 45:
 Haben die MULTI-Verknüpfungen unterschiedliche Bahnsteige, muss natürlich der Referenzbahnsteig ebenfalls unterschiedlich sein. Haben die MULTI-Verknüpfungen unterschiedliche Bahnsteige, muss natürlich der Referenzbahnsteig ebenfalls unterschiedlich sein.
  
-===== Abfahrtszeit (STUNDE und MILZEIT) =====+==== Abfahrtszeit (STUNDE und MILZEIT) ====
  
 Mit den Parametern STUNDE und MILZEIT wird festgelegt, zu welche Uhrzeit die erzeugten Züge am Referenzbahnsteig **abfahren** sollen. Dabei haben sie folgendes Format (hh ist die Stunde, mm die Minute): Mit den Parametern STUNDE und MILZEIT wird festgelegt, zu welche Uhrzeit die erzeugten Züge am Referenzbahnsteig **abfahren** sollen. Dabei haben sie folgendes Format (hh ist die Stunde, mm die Minute):
Zeile 61: Zeile 64:
 Innerhalb eines takt()-Befehls dürfen mehrere STUNDE und MILZEIT vorkommen und auch gemischt werden: Innerhalb eines takt()-Befehls dürfen mehrere STUNDE und MILZEIT vorkommen und auch gemischt werden:
   takt(60,ID=123,GLEIS=A1,STUNDE=5,MILZEIT=1022,STUNDE=18);   takt(60,ID=123,GLEIS=A1,STUNDE=5,MILZEIT=1022,STUNDE=18);
 +\\
  
-==== Zeitbereiche ====+=== Zeitbereiche ===
  
 Es können mit einem STUNDE oder MILZEIT mehrere Züge im Takt erzeugt werden: Es können mit einem STUNDE oder MILZEIT mehrere Züge im Takt erzeugt werden:
- 
   takt(60,ID=123,GLEIS=A1,STUNDE=6..12);   takt(60,ID=123,GLEIS=A1,STUNDE=6..12);
  
Zeile 81: Zeile 84:
   Zug 6 (11:25)   Zug 6 (11:25)
  
-In MILZEIT könnte das Ganze so aus: +In MILZEIT könnte das Ganze so aussehen:
   takt(60,ID=123,GLEIS=A1,MILZEIT=625..1126);   takt(60,ID=123,GLEIS=A1,MILZEIT=625..1126);
   takt(60,ID=123,GLEIS=A1,MILZEIT=625..1225);   takt(60,ID=123,GLEIS=A1,MILZEIT=625..1225);
Zeile 107: Zeile 109:
   takt(20,ID=123,GLEIS=A1,MILZEIT=625..800);   takt(20,ID=123,GLEIS=A1,MILZEIT=625..800);
  
-==== MILZEIT vs. STUNDE ====+=== MILZEIT vs. STUNDE ===
  
 Grundsätzlich ließen sich alle Züge mit MILZEIT bauen. Allerdings ergeben sich bei kleinen Zeit-Verschiebungen am Referenzbahnsteig schnell Fehler, weil der gesamte restliche Fahrplan verschoben wird. Deshalb soll nur in folgenden Fällen MILZEIT verwendet werden: Grundsätzlich ließen sich alle Züge mit MILZEIT bauen. Allerdings ergeben sich bei kleinen Zeit-Verschiebungen am Referenzbahnsteig schnell Fehler, weil der gesamte restliche Fahrplan verschoben wird. Deshalb soll nur in folgenden Fällen MILZEIT verwendet werden:
Zeile 119: Zeile 121:
 Trotzdem kann es zu diesen Verschiebungseffekten auch bei STUNDE kommen! Trotzdem kann es zu diesen Verschiebungseffekten auch bei STUNDE kommen!
  
-=== Beispiel ===+== Beispiel ==
  
-Beispiel: Eine RB fährt wie folgt:+Eine RB fährt wie folgt:
  
 ^ an ^ ab ^ Gleis ^ ^ an ^ ab ^ Gleis ^
Zeile 132: Zeile 134:
   takt(60,ID=123,GLEIS=C,MILZEIT=0950);   takt(60,ID=123,GLEIS=C,MILZEIT=0950);
  
-Wird jetzt der Template-Fahrplan in C-Heim auf 09:52 geändert, fahren die erzeugten Züge nicht um 09:52 in C-Heim ab, sondern nach Zugscript um 09:50 - und dafür an allen anderen Halten 2 Minuten früher:+Wird jetzt der Zugtemplate-Fahrplan in C-Heim auf 09:52 geändert, fahren die erzeugten Züge nicht um 09:52 in C-Heim ab, sondern nach Zugscript um 09:50 - und dafür an allen anderen Halten 2 Minuten früher:
  
 ^ an ^ ab ^ Gleis ^ ^ an ^ ab ^ Gleis ^
Zeile 142: Zeile 144:
 Dadurch ergeben sich insbesondere Änderungen in anderen Stellwerken und Regionen. Dadurch ergeben sich insbesondere Änderungen in anderen Stellwerken und Regionen.
  
-===== Mehrfache Verknüpfungen (MULTI) =====+==== Mehrfache Verknüpfungen (MULTI) ====
  
-Wenn in einem Template mehrere Züge vorhanden sind, die auf unterschiedliche Nachfolger verknüpft werden sollen, kann pro Zugscript-Zeile festgelegt werden, welche Verknüpfung verwendet werden soll. Die Beschreibung und Regeln dafür finden sich beim [[stellwerksim:erbauer:zugbau:flags:multi|Multi-Flag]].+Wenn in einem Zugtemplate mehrere Züge vorhanden sind, die auf unterschiedliche Nachfolger verknüpft werden sollen, kann pro Zugscript-Zeile festgelegt werden, welche Verknüpfung verwendet werden soll. Die Beschreibung und Regeln dafür finden sich beim [[stellwerksim:erbauer:zugbau:flags:multi|Multi-Flag]].
  
-===== Namensmuster im Zugscript (NAME) =====+==== Themamarker (MARKER) ====
  
-Mit dem Parameter NAME kann das Namensmuster in die Zugscript-Zeile aufgenommen werden. Dadurch ist es möglich, verschiedene Namen oder Lücken innerhalb eines Templates darzustellen.+Ist ein MARKER gesetzt, werden für den Zug nur diejenigen Fahrplanhalte übernommen, die diesen Themamarker gesetzt haben. Damit kann für einzelne Züge ein abweichender Fahrplan definiert werden, ohne ein eigenes Zugtemplate verwenden zu müssen - auf Kosten der Lesbarkeit des Fahrplans. Dabei sind folgende Regeln zu beachten: 
 + 
 +  * Jeder Zug kann höchstens einen MARKER haben. 
 +  * Hat mindestens ein Zugscript einen MARKER gesetzt, muss jedes Zugscript in diesem Zugtemplate einen MARKER gesetzt haben. Es müssen also entweder alle Zugscripte oder kein Zugscript MARKER enthalten. 
 +  * Wird MARKER verwendet müssen alle Referenzgleise Themamarker A-Z gesetzt hat. 
 +  * Die Zug-QS stellt [[stellwerksim:erbauer:zug-qs:fuererbauer:templateregeln#verwendung_von_marker|konkretere Regeln für die Verwendung von MARKER]] auf 
 + 
 +Der Zugscriptlauf übernimmt dann pro Zug nur diejenigen Fahrplaneinträge, die den gewählten Marker gesetzt haben, und setzt im Zug den Themamarker A-Z.  
 + 
 +<note>Die Züge haben also andere Themamarker als das Zugtemplate. Damit ist das [[stellwerksim:erbauer:themascripte:sim_befehle|Setzen eines Themamarkers per ThemaScript (Befehl themamarker)]] ohne Auswirkung, weil der Fahrplan des Zuges für alle Themamarker gleich ist.</note> 
 + 
 +<note important>Die Regeln für Verknüpfungsbahnsteige gelten unabhängig von MARKER - Verknüpfungsbahnsteige müssen also auch im Zugtemplate immer Themamarker A-Z gesetzt haben. Das gilt insbesondere auch für Zielbahnsteige von E/F/K-Flags!</note> 
 + 
 +== Beispiel == 
 +Ein Zug im Zugtemplate soll an einem Halt einen anderen Bahnsteig verwenden. Im [[stellwerksim:erbauer:zugbau:fahrplan|Fahrplaneditor]] werden zwei Fahrplanhalte für diesen Bahnhof angelegt: 
 +  * Ein Fahrplanhalt mit dem Standard-Gleis mit Themamarker A und C-Z 
 +  * Ein Fahrplanhalt mit dem abweichenden Gleis mit Themamarker B 
 + 
 +Im Zugscript gibt es dann folgende Zeilen: 
 +  takt(60,ID=123,GLEIS=A1,STUNDE=6..8,MARKER=A); 
 +  takt(60,ID=123,GLEIS=A1,STUNDE=8,MARKER=B); 
 +  takt(60,ID=123,GLEIS=A1,STUNDE=9..20,MARKER=A); 
 + 
 +Damit hat der Zug zur Stunde 8 den abweichenden Bahnsteig, alle anderen den normalen Bahnsteig. 
 + 
 +==== Namensmuster im Zugscript (NAME) ==== 
 + 
 +Mit dem Parameter NAME kann das Namensmuster in die Zugscript-Zeile aufgenommen werden. Dadurch ist es möglich, verschiedene Namen oder Lücken innerhalb eines Zugtemplates darzustellen.
  
 Die genaue Erklärung steht auf der Seite des [[stellwerksim:erbauer:zugbau:namensmuster|Namensmusters]]. Die genaue Erklärung steht auf der Seite des [[stellwerksim:erbauer:zugbau:namensmuster|Namensmusters]].
 +
 +==== Tools für das Zugscript ====
 +
 +=== Zugscript prüfen ===
 +
 +Rechts neben jedem Eingabefeld für das Zugscript gibt es ein kleines i in einem grauen Kreis. Ein Klick darauf prüft das Zugscript auf häufige Fehler und gibt Tipps für Korrekturen.
 +
 +Diese Prüfung wird auch jedes Mal ausgeführt, wenn das Zugscript geändert wird.
 +
 +=== Automatische Referenzgleisänderung ===
 +
 +Rechts neben jedem Eingabefeld für das Zugscript gibt es ein kleines Icon mit zwei verzweigten Pfeilen. Mit diesem kann das Referenzgleis des Zugscripts verschoben werden, ohne dass sich die erzeugten Züge ändern - STUNDE und MILZEIT werden entsprechend angepasst.
 +
 +Bei Klick auf das Icon öffnet sich darunter ein Eingabefeld, wo das neue Referenzgleis ausgewählt werden kann. 
 +
 +{{:stellwerksim:erbauer:zugbau:referenzgleis_verschieben.png}}
 +
 +Mit Klick auf "verschieben" werden ID, GLEIS sowie alle STUNDE und MILZEIT an das neue Referenzgleis angepasst. Die Funktion berücksichtigt dabei eventuell vorhandenes MULTI.
  
 {{tag>Werte, Zugbau}} {{tag>Werte, Zugbau}}
stellwerksim/erbauer/zugbau/zugscript.1547918758.txt.gz · Zuletzt geändert: 2019/01/19 18:25 von DevonFrosch

Seiten-Werkzeuge

Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki