GreenFlow

The Following Explanation will be in German as this is dedicated to a schoolproject. However, the code and all comments are still in engish.

Greenflow - Schulprojekt zur Simulation einer Ampel im Rahmen der "Wissenschaftswoche"

Beschreibung

Ananlyse und Auswertung von Wartezeiten sowie Kraftstoffverbrauch von Autos auf einer Kreuzung, wobei die Parameter für die Anzahl an Fahrzeugen, die Ampelzeiten sowie die größe der Straße und viele weitere minimale Änderungen angepasst werden können.

Dieses Projekt wurde innerhalb von 3 Tagen umgesetzt und wird jetzt vorraussichtlich nicht mehr weiter entwickelt. Es gibt einige Ansätze für erweiterte Features welche aber aus Zeitgründen nicht weiter realisiert wurden.

Funktionen

• Anpassen der einzelnen Fahrspuren pro Himmelsrichtung mit bestimmten Richtungsmöglichkeiten beim Abbiegen.
• Anpassen der Fahrzeug-Metadaten wie Kraftstoffverbrauch, maximale Beschleunigung usw.
• Anpassen der Ampelphasen Zeiten sowie das hinzufügen verschiedener statischer Ampelmodi
• Auswertung jedes einzelnen Fahrzeugs mit Wartezeit, Anzahl Stopps und Kraftstoffverbrauch
• Berechnung relevanter Statistiken wie den Durchschnittswerten aus den oben genannten Daten.
• Exportierung im JSON-Format der einfachen Statistiken mit Configuration sowie den Rohdaten der einzelnen Fahrzeuge.

Vorschau

Nutzung

Aus Zeit-Technischen Gründen ist die Konfiguration nur in den Code-Files und nicht in der Website selber möglich, daher ist die Nutzung eines einfachen Development-Server am einfachsten.

1. Stelle sicher dass du NodeJS installiert hast.
2. Klone das Projekt auf dein eigenes Gerät.
3. installiere die node_modules mit npm install.
4. Development-Server starten: npm run dev
5. Öffne die Website auf localhost:8081.

Alternativ gibt es auch eine Preview auf greenflow.tim-fischer.dev. Dort können aber wie breits erwähnt nicht die Parameter angepasst werden.

Contributing

Du möchtest einzelne Elemente noch verbessern oder die angesetzten Features wie zum beispiel Konfiguration auf der Website selbst noch implementieren? Du kannst dazu gerne eine Pull-Requst öffnen, auch wenn ich selber nicht mehr an dem Projekt arbeite, werde ich die PR anschauen und gegebenenfalls mergen.

Sonstiges

Da es sich hier um ein Schulprojekt handelt gibt es unter media/ noch einige weitere Files die für die Benotung relevant waren. Allgemein ist das Projekt relativ wenig dokumentiert, die Dokumente in /media könnten unter umständen helfen, sind allerdings nicht darauf ausgelegt. Durch die Kurze Zeitspanne von weniger als 4 Tagen wurde hier hauptsächlich auf schnelle Ergebnisse geachtet. Einzelne Systeme wie die Kollisions-Erkennung ist alles andere als perfekt und es wird sicherlich noch mehr Bugs geben.

Licences

• The code in /src (and root) is licensed under the MIT Licence. (see ./LICENCE)
• All content in /media is proprietary and all rights reserved. (see ./media/LICENCE)