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
+12-8Lines changed: 12 additions & 8 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,19 +4,23 @@ 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
+
7
9
Concept
8
10
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:
11
+
Freight trading is all about moving cargo efficiently—matching shipments with transport capacity and making smart delivery decisions. This project captures that by:
10
12
11
13
Treating trucks like transport capacity and loads like shipments.
12
14
13
-
Automatically assigning trucks to loads based on their capacity and location.
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.
14
18
15
-
Letting you create new loads dynamically, which is like new opportunities popping up in the market.
19
+
Running a continuous simulation loop that updates trucks and loads every second.
16
20
17
-
Updating everything live so you can see trucks move toward their destinations.
21
+
Tracking financial metrics for each truck: profit, expenses, and net profit.
18
22
19
-
It’s a simplified way to explore how freight trading works without having to charter real ships or trucks.
23
+
This is a simplified way to explore how freight trading works without using real trucks or logistics systems.
20
24
21
25
Project Structure
22
26
freight_project/
@@ -84,13 +88,13 @@ Enter simulation parameters and click Start Simulation.
84
88
85
89
Click Create Random Load to add new shipments dynamically.
86
90
87
-
CLI (Optional)
91
+
CLI
88
92
89
93
Go to the cli/ folder.
90
94
91
95
Run:
92
96
93
-
python main.py
97
+
python3 main.py
94
98
95
99
96
100
Follow the prompts to simulate trucks and loads step by step.
@@ -105,7 +109,7 @@ Automatic assignment of trucks based on capacity and location.
105
109
106
110
Dashed lines that show the path from trucks to their assigned loads.
107
111
108
-
Optional CLI version for terminal-based simulation.
0 commit comments