You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: freight_project/readme.md
+8-12Lines changed: 8 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,23 +4,19 @@ OwlHacks 2025 Hackathon Project
4
4
5
5
This project is a freight trading simulator I built for OwlHacks 2025. The idea is to mimic how trucks and shipments are matched in real life, so you can see who’s carrying what, track deliveries, and even create new loads on the fly. Everything is interactive and plotted on a map so you can watch the simulation happen in real-time.
6
6
7
-
The simulation also tracks financial metrics for each truck, including profit, expenses, and net profit.
8
-
9
7
Concept
10
8
11
-
Freight trading is all about moving cargo efficiently—matching shipments with transport capacity and making smart delivery decisions. This project captures that by:
9
+
Freight trading is all about moving cargo efficiently—matching shipments with transport capacity and making smart delivery decisions. I tried to capture that in this project by:
12
10
13
11
Treating trucks like transport capacity and loads like shipments.
14
12
15
-
Automatically assigning trucks to loads based on capacity, location, and availability.
16
-
17
-
Allowing the creation of new loads dynamically, simulating new market opportunities.
13
+
Automatically assigning trucks to loads based on their capacity and location.
18
14
19
-
Running a continuous simulation loop that updates trucks and loads every second.
15
+
Letting you create new loads dynamically, which is like new opportunities popping up in the market.
20
16
21
-
Tracking financial metrics for each truck: profit, expenses, and net profit.
17
+
Updating everything live so you can see trucks move toward their destinations.
22
18
23
-
This is a simplified way to explore how freight trading works without using real trucks or logistics systems.
19
+
It’s a simplified way to explore how freight trading works without having to charter real ships or trucks.
24
20
25
21
Project Structure
26
22
freight_project/
@@ -88,13 +84,13 @@ Enter simulation parameters and click Start Simulation.
88
84
89
85
Click Create Random Load to add new shipments dynamically.
90
86
91
-
CLI
87
+
CLI (Optional)
92
88
93
89
Go to the cli/ folder.
94
90
95
91
Run:
96
92
97
-
python3 main.py
93
+
python main.py
98
94
99
95
100
96
Follow the prompts to simulate trucks and loads step by step.
@@ -109,7 +105,7 @@ Automatic assignment of trucks based on capacity and location.
109
105
110
106
Dashed lines that show the path from trucks to their assigned loads.
111
107
112
-
CLI version for terminal-based simulation.
108
+
Optional CLI version for terminal-based simulation.
0 commit comments