Netze beschreiben

Ein Netz besteht aus Gleisen, Weichen und Netzenden, die über Ports verbunden sind, dazu Signalen, Bahnübergängen und Gleisfreimeldeabschnitten. rail-it liest es aus einem kompakten TOML-Format, aus railML 3 oder aus PlanPro. Die vollständige Beschreibung aller Schlüssel steht in der Referenz.

Topologie mit Ports

Jedes Element hat feste Ports:

Element	Ports
Gleis (track)	a, b – Richtung a_to_b läuft von a nach b
Weiche (point)	tip (Spitze), left, right
Netzende (terminal)	end

Verbindungen (link) verbinden genau zwei Ports. Die Beispielstadt:

[network]
name = "Beispielstadt"

[[terminal]]
name = "GW"
kind = "boundary"          # Netzgrenze; außerdem buffer_stop, border

[[track]]
name = "west"
length_m = 1000

[[point]]
name = "W1"
diverging = "right"        # abzweigender Strang
diverging_speed_kmh = 40

[[link]]
from = "GW.end"
to = "west.a"

[[link]]
from = "west.b"
to = "W1.tip"

Signale und Bahnübergänge

Signale stehen auf einem Gleis, mit Position ab Port a und einer Wirkrichtung:

[[signal]]
name = "A"
track = "west"
position_m = 1000
direction = "a_to_b"
kind = "combined"          # main, distant, combined, shunting, etcs_stop_marker
system = "ks"              # ks oder hv

[[level_crossing]]
name = "BÜ1"
track = "east"
position_m = 500

Hauptsignale an Abschnittsgrenzen

Ein Hauptsignal muss an einer Gleisfreimeldegrenze stehen – am Gleisende oder bis zu 30 m davor, wie in Planungen, deren Achszählpunkt einige Meter hinter dem Signal liegt. Zwischen Signal und Gleisende darf kein Bahnübergang und keine Kreuzung liegen. Die Validierung meldet Signale an anderen Stellen (REQ-PLN-010).

Kreuzungen und Kreuzungsweichen

Eine Kreuzung ohne bewegliche Teile ([[crossing]]) verbindet keine Gleise; beide Kreuzungsstellen liegen im selben Gleisfreimeldeabschnitt (examples/kreuzung.toml).

Eine Kreuzungsweiche beschreibt [[slip]] als Ganzes; rail-it legt Zungenpaare, innere Gleise, Kreuzung, Kopplungen und Abschnitt selbst an (examples/dkw.toml):

[[slip]]
name = "DKW1"
kind = "double"            # single (EKW) oder double (DKW)
length_m = 40
curve_speed_kmh = 40

[[link]]
from = "w1.b"
to = "DKW1.a"              # Enden a, b auf der einen, c, d auf der anderen Seite

Gerade führen a–c und b–d über die Kreuzung, die Bögen a–d und (nur DKW) b–c. Die Zungenpaare DKW1a … DKW1d lassen sich wie Weichen bedienen; jedes nimmt das gekoppelte Zungenpaar seines Endes mit. Zwei beliebige Weichen an einem gemeinsamen Antrieb, etwa eine Weichenverbindung, koppelt [[coupling]] (siehe Referenz).

Gleisfreimeldung

Jedes Gleis und jede Weiche gehört zu genau einem Gleisfreimeldeabschnitt; Lücken weist die Validierung ab:

[[tvd]]
name = "TW1"
elements = ["W1"]

Prüfen und ansehen

railit net validate netz.toml        # alle Fehler auf einmal
railit net info netz.toml            # Elemente, Signale, Abschnitte
railit net layout netz.toml --out netz.svg
railit net export netz.toml --out netz.railml   # als railML 3

validate prüft unter anderem: eindeutige Namen, jede Verbindung genau einmal, keine offenen Ports, zusammenhängendes Netz, Signale auf existierenden Gleisen innerhalb der Gleislänge, lückenlose Gleisfreimeldung, Weichen mit genau einem abzweigenden Strang.

railML 3

railit net validate netz.railml
railit plan compile netz.railml --out plan.rplan --key railit.key

Der Import ergänzt und rät nichts: Was railML nicht eindeutig angibt, wird gemeldet. Ein exportiertes Netz liest rail-it unverändert wieder ein; der Plan ist bitgleich (REQ-TOP-014).

PlanPro

Planungen deutscher Stellwerke liegen als PlanPro vor. rail-it liest PlanPro 1.9 und 1.10 direkt und schreibt PlanPro 1.10:

railit net validate examples/abzweig.ppxml          # Warnungen nennen übergangene Objekte
railit plan compile examples/abzweig.ppxml --out abzweig.rplan --key railit.key
railit scenario run tests/scenarios/23_planpro_abzweig.toml
railit net export examples/beispielstadt.toml --out beispielstadt.ppxml

Auch hier wird nichts geraten: Fehlt eine Wirkrichtung, eine Bezeichnung oder das Signalsystem, nennt der Import das PlanPro-Objekt (REQ-TOP-015). Die Abbildung steht in der Referenz.

Große Netze erzeugen

Für Lasttests erzeugt railit net generate einen Korridor aus vielen Bahnhöfen:

railit net generate --stations 236 --out korridor.toml   # ≈ 5000 Elemente