CityTrafficSimulator Handbuch
Da die Bedienung von CityTrafficSimulator vielleicht nicht für jeden selbsterklärend und intuitiv ist, an dieser Stelle ein kurzes Handbuch.
Installation
CityTrafficSimulator benötigt keine extra Installation - entpacken Sie lediglich das ZIP-Archiv an eine Ihnen genehme Stelle und führen Sie das Programm von dort aus.Oberfläche
Die Oberfläche von CityTrafficSimulator ist in 3 Bereiche aufgeteilt:Den größten Bereich nimmt die Zeichenfläche dar, in der die eigentliche Verkehrssimulation stattfindet.
Rechts daneben ist eine Spalte in der Einstellungen in drei verschiedenen Reitern vorgenommen werden können: Unter Layout kann man die einzelnen Knotenpunkte und Verbindungen einstellen und das Verkehrsmodell speichern/laden. Unter Verkehr erstellt man Fahraufträge die festlegen wie oft Autos von bestimmten Knoten zu anderen Knoten fahren sollen. Unter Ansicht kann man schließlich verschiedene Darstellungsoptionen einstellen.
Am unteren Rand befindet sich die Zeitleiste für die Ampeln. Hier kann man die verschiedenen Rot-/Grünphasen der Ampeln bestimmen.
Zeichenfläche
Hier wird das Straßenmodell angezeigt und bearbeitet. Wichtigstes Werkzeug dabei ist die Maus:Existierende Knoten und Verbindungen können mit der linken Maustaste markiert und per Drag & Drop verschoben werden. Hat man einen Knotenpunkt ausgewählt erscheinen noch zwei Ankerpunkte, die die Krümmung der Bézierkurven und die Durchfahrtsrichtung anzeigen (Knoten und Linien können stets nur in einer Richtung durchfahren werden!). Per Drag & Drop kann man auch die Ankerpunkte verschieben. Standardmäßig wird der gegenüberliegende Ankerpunkt stets gespiegelt um keine Knicke in den Straßenverlauf zu bekommen. Bei gedrückter ALT-Taste lässt sich dieses Verhalten jedoch unterbinden.
Um neue Knotenpunkte zu erstellen klicken Sie bei gedrückter STRG-Taste mit der linken Maustaste. Halten sie die Maustaste gedrückt, so können sich sofort per Drag & Drop die Position der Ankerpunkte festlegen. War vorher bereits ein Knotenpunkt ausgewählt, so wird dieser automatisch mit dem neu erstellten Knoten verbunden. Straßenzüge lassen sich also ohne große Unterbrechungen fortsetzen.
Möchten Sie zwei bereits existierende Knotenpunkte miteinander verbinden, so wählen Sie zunächst den Startknoten aus und klicken Sie dann bei gedrückter ALT-Taste auf den Zielknoten. So wird eine neue Verbindung zwischen den beiden Knoten erstellt.
Möchten Sie eine Verbindung löschen, so wählen Sie sie zunächst aus und drücken dann die Entfernen-Taste. Die Verbindung wird gelöscht. Alternativ können Sie auch einzelne Knotenpunkte löschen indem Sie auswählen und die Entfernen-Taste drücken. Alternativ können Sie bei gedrückter STRG-Taste auf den Koten rechtsklicken. Achtung: alle Verbindungen des Knotens werden ebenfalls gelöscht!
Um bestehende Verbindungen in der Mitte zu teilen wählen Sie die Verbindung zunächst aus und drücken sie dann die S-Taste (S steht für subdivide).
Layout-Reiter
Hier stellen Sie grundlegende Dinge der Knotenpunkte und Verbindungen ein:Haben Sie in der Zeichenfläche einen Knoten ausgewählt, dann können sie unter "Ampel" festlegen, ob an dieser Stelle eine Ampel sein soll oder nicht. Die Rot-/Grünphasen stellen sie in der Zeitleiste im unteren Bereich ein (s.u.).
Haben Sie eine Verbindung ausgewählt, sö können Sie mit Priorität festlegen, wie wichtig diese Verbindung ist: Fahrzeuge auf Verbindungen höherer Priorität haben Vorfahrt gegenüber Fahrzeugen auf Verbindungen geringerer Priorität.
Unter Information können Sie beliebigen Text eingeben, der zusammen mit dem Layout gespeichert werden soll.
Mit den Laden/Speichern Buttons können Sie ihr aktuelles Projekt speichern, bzw. gespeicherte Projekte laden. Dabei wird sowohl das Layout, die Ampelphasen als auch unter "Verkehr" eingestellte Fahraufträge in eine XML-Datei gespeichert.
Achtung beim Laden: die Funktion ist alles andere als robust implementiert, fehlerhafte XML-Dateien können zu Abstürzen des Programmes oder anderen lustigen und unerwarteten Effekten führen. (In der Regel hagelt es aber nur NullPointerExceptions o.ä.)
Verkehr-Reiter
Das schönste Straßenmodell bringt einem wenig, wenn dort keine Autos fahren. Hier können Sie Verkehr entstehen lassen:Sie müssen vorher festlegen von wo nach wo die Autos fahren wollen: Wählen Sie zunächst den Startknoten in der Zeichenfläche aus. Drücken sie die V-Taste (von). Als Rückmeldung sehen Sie, wie der Knoten grün umkreist ist. Wählen Sie dann den Zielknoten und drücken Sie die N-Taste (nach). Nun können Sie Fahrtaufträge bestimmen:
Unter "einzelnes Fahrzeug erstellen" können Sie genau das tun. Bestimmen sie die Wunschgeschwindigkeit in m/s und klicken Sie auf neues Auto. Wenn sich nichts bewegt, vergewissern Sie sich, dass die Simulation läuft (siehe Zeitleiste).
Im oberen Teil des Reiters können Sie periodische Aufträge vergeben. Auch hierfür bestimmen Sie Start- und Zielknoten und wählen noch die Periodendauer in Ticks. Ein Tick entspricht einer Zwanzigstel Sekunde (1 Tick = 1/20s). Klicken Sie dann auf Neu und der Fahrauftrag wird in die obige Liste eingetragen.
Mit Löschen können Sie selektierte Aufträge löschen. Außerdem können Sie nachträglich auch die Intervalllänge oder Start-/Zielknoten neu definieren (letzteres per Button oder alternativ mit STRG+V oder STRG+N).
Ansicht-Reiter
Der wichtigste Punkt unter Ansicht ist der Zoomfaktor. CityTrafficSimulator arbeitet mit einem Maßstab von 10Pixel/m. Das macht große Kreuzungen bei 100% Zoom ziemlich unübersichtlich. Sie können jedoch auch deutlich kleineren Zoom auswählen. Shortcut STRG+NUM+ bzw STRG+NUM-.Sie haben außerdem die Möglichkeit diverse Debuginformationen einblenden zu lassen. Dies kostet jedoch viel (!) Rechenleistung und dient eher der Fehlersuche. So werden zum Beispiel in der Debugansicht Kreuzungen rot hervorgerufen und Informationen zur Geschwindigkeit der Fahrzeuge eingeblendet.
Mit "Dock to Grid" können sie ein festes Raster von 10x10 Pixeln für die Zeichenfläche einrichten. Alles wird an diesem Raster ausgerichtet.
Schließlich können Sie noch ein Hintergrundbild einrichten, dies ist z.B. praktisch wenn man real existierende Kreuzungen modellieren will. (Screenshots aus GoogleMaps eignen sich hervorragend als Vorlage - man muss jedoch den Maßstab anpassen!)
Zeitleiste
Der wichtigste Knopf hier ist "Timer an" womit sie die eigentliche Simulation ein- und ausschalten. Bei angehaltener Simulation können sie mit "Step!" einen Einzelschrittdurchlauf durchführen.Sollten sich einige Autos nachhaltig verhakt haben o.ä., so können Sie dieses Problem mit "alle Autos töten" mit einem Radikalschlag aus der Welt schaffen.
Links ist die Zeitleiste, die einen Überblick über die Ampelphasen darstellt. Standardmäßig sind alle Ampeln immer rot. Hier können Sie jetzt Grünphasen erstellen:
Wählen sie die zu bearbeitende Ampel aus klicken sie bei gehaltener STRG-Taste mit Links, so wird an der Stelle eine Grünphasen begonnen. Diese können sie nun per Drag & Drop noch verschieben oder Anfangs-/Endposition ändern. Grünphasen müssen jedoch immer mindestens 1 Sekunde lang sein.
Existierende Grünphasen können mit STRG+Rechtsklick wieder gelöscht werden.
Sonstiges
Da diess Handbuch keinerlei Anspruch auf Vollständigkeit hat und nur als Leitfaden dienen soll, kann es durchaus sein, dass noch Unklarheiten bleiben.Wenn Sie Fragen oder Anmerkungen haben schreiben Sie mir eine kurze Mail an software@cszb.net . Ein Hinweis noch: Dieses Programm ist noch in der Entwicklung, das heißt insbesondere, dass es noch viele Dinge gibt, die nur teilweise oder gar nicht funktionieren. Genauso kann es immer wieder zu Fehlern oder Abstürzen kommen.
Ich teste zwar regelmäßig jedoch freue ich mir über jede Mail mit Anmerkungen oder konstruktiver Kritik. Aber bitte haben Sie auch Verständnis dafür, dass dies ein reines Hobbyprodukt ist und ich momentan mehr Wert auf interessante Algorithmen und den Ausbau der Funktionalität als auf fehlerfreie Produkte lege.
www.cszb.net - Design und Content by Christian Schulte zu Berge