Jing997 commited on
Commit
a26580f
Β·
1 Parent(s): 5aacfde

Set README

Browse files
Files changed (1) hide show
  1. README.md +8 -107
README.md CHANGED
@@ -1,110 +1,11 @@
1
- # [Project: Delivery Route Optimization](https://huggingface.co/spaces/Jing997/DeliveryRouteOptimisation)
2
-
3
- ![Delivery Route Optimization Demo](gif/delivery_route_optimisation.gif)
4
-
5
- This project is a **Delivery Route Optimization** tool built using Streamlit. It aims to optimize delivery routes for a fleet of vehicles while considering constraints such as delivery time windows, vehicle capacity, and traffic conditions.
6
-
7
-
8
- ### Key Features
9
- 1. **Route Optimization**:
10
- - Solve the **Vehicle Routing Problem (VRP)** to determine the most efficient routes for a fleet of vehicles.
11
- - Incorporate constraints like:
12
- - Delivery time windows.
13
- - Vehicle capacity.
14
- - Traffic conditions.
15
-
16
- 2. **Map Visualization**:
17
- - Display optimized routes on an interactive map using **Folium**.
18
- - Highlight delivery stops, start and end points, and route distances.
19
-
20
- 3. **Calendar View**:
21
- - Provide a calendar-based schedule for deliveries.
22
- - Allow users to view and manage delivery schedules for specific days or weeks.
23
-
24
- 4. **Real-Time Updates**:
25
- - Enable real-time updates for route changes due to unexpected events (e.g., traffic congestion, vehicle breakdowns).
26
- - Re-optimize routes dynamically and update the map and calendar views.
27
-
28
- ### Tools and Technologies
29
- - **Python**: Core programming language for optimization and application logic.
30
- - **Google OR-Tools**: Solve the Vehicle Routing Problem (VRP) with constraints.
31
- - **Streamlit**: Build an interactive web application for route visualization and schedule management.
32
- - **Folium**: Create interactive maps for route visualization.
33
- - **Synthetic Data**: Integrate real-time traffic data for dynamic route adjustments.
34
-
35
  ---
36
-
37
- ## Project Structure
38
-
39
- ```
40
- streamlit-app-template
41
- β”œβ”€β”€ src
42
- β”‚ β”œβ”€β”€ app.py # Main entry point of the Streamlit application
43
- β”‚ β”œβ”€β”€ components # Directory for reusable UI components
44
- β”‚ β”‚ └── __init__.py
45
- β”‚ β”œβ”€β”€ pages # Directory for different pages of the application
46
- β”‚ β”‚ └── __init__.py
47
- β”‚ β”œβ”€β”€ utils # Directory for utility functions
48
- β”‚ β”‚ └── __init__.py
49
- β”œβ”€β”€ requirements.txt # List of dependencies for the application
50
- β”œβ”€β”€ .streamlit # Configuration settings for Streamlit
51
- β”‚ β”œβ”€β”€ config.toml
52
- β”œβ”€β”€ img # Folder for storing images
53
- β”‚ └── delivery_route_network.png
54
- β”œβ”€β”€ .gitignore # Files and directories to ignore in Git
55
- β”œβ”€β”€ README.md # Documentation for the project
56
- └── LICENSE # Licensing information
57
- ```
58
-
59
  ---
60
 
61
- ## Installation
62
-
63
- To get started with this Streamlit application template, follow these steps:
64
-
65
- 1. Clone the repository:
66
- ```
67
- git clone https://github.com/yourusername/streamlit-app-template.git
68
- cd streamlit-app-template
69
- ```
70
-
71
- 2. Create a virtual environment (optional but recommended):
72
- ```
73
- python -m venv venv
74
- source venv/bin/activate # On macOS/Linux
75
- venv\Scripts\activate # On Windows
76
- ```
77
-
78
- 3. Install the required dependencies:
79
- ```
80
- pip install -r requirements.txt
81
- ```
82
-
83
- 4. Run the Streamlit application:
84
- ```
85
- streamlit run src/app.py
86
- ```
87
-
88
- ---
89
-
90
- ## Deployment
91
-
92
- This application is deployed on Hugging Face Spaces and is accessible at:
93
-
94
- πŸš€ [Delivery Route Optimization App](https://huggingface.co/spaces/Jing997/DeliveryRouteOptimisation)
95
-
96
- The deployed version provides all the features of the local application without requiring any installation. You can:
97
-
98
- - View and analyze optimized delivery routes
99
- - Interact with the map visualization
100
- - Explore the calendar view of scheduled deliveries
101
- - Test different optimization parameters
102
- - Filter deliveries by date, status, and priority
103
-
104
- The app is automatically updated whenever changes are pushed to the connected GitHub repository.
105
-
106
- ---
107
-
108
- ## License
109
-
110
- This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
1
  ---
2
+ title: DeliveryRouteOptimisation
3
+ emoji: 🌍
4
+ colorFrom: yellow
5
+ colorTo: red
6
+ sdk: docker
7
+ pinned: false
8
+ license: gpl-2.0
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
9
  ---
10
 
11
+ Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference