CoolFace
Apppublic

asrulharunismail/FTZ_MULTI-MODAL_MEDICAL_LOGISTICS

sourceHugging Facemitupdated 10mo agoView on Hugging Face
0likes
App README

๐Ÿš› Multi-Modal Vehicle Routing Optimization System

An advanced optimization system for last-mile delivery using bikes, vans, and drones with emissions-focused routing.

๐ŸŒŸ Features

  • โ€”Multi-Modal Routing: Optimizes delivery routes using bikes, electric vans, and drones
  • โ€”Emissions Focus: 92% weight on emissions reduction for sustainable logistics
  • โ€”City Selection: Pre-configured datasets for Southampton and Portsmouth
  • โ€”Pair Constraints: Ensures drone pairs operate within time limits
  • โ€”Interactive Visualization: Folium maps showing all optimized routes
  • โ€”Complete Pipeline: P-Hub Allocation โ†’ TSP โ†’ Vehicle Routing with Bees Algorithm

๐Ÿ™๏ธ Available Cities

Southampton (Matrices2PY.xlsx)

  • โ€”78 nodes dataset
  • โ€”Full network coverage
  • โ€”Multiple depot configuration

Portsmouth (Matrices1PY.xlsx)

  • โ€”Alternative city configuration
  • โ€”Optimized for different network topology

๐Ÿ“Š Optimization Pipeline

  1. 1.Phase 1: P-Hub Allocation & Bike Routes
  2. 2.Allocates customers to hubs
  3. 3.Generates bike delivery routes
  1. 1.Phase 1.5: TSP Input Preparation
  2. 2.Filters zero-demand nodes
  3. 3.Prepares matrices for TSP
  1. 1.Phase 2: TSP Optimization
  2. 2.Domino algorithm for tour construction
  3. 3.Optimizes customer visit sequence
  1. 1.Phase 2.5: Matrix Processing
  2. 2.Depot relabeling (0โ†’101, 1โ†’102)
  3. 3.Final matrix preparation
  1. 1.Phase 3: Vehicle Routing with Bees Algorithm
  2. 2.Greedy segment construction
  3. 3.Bees Algorithm optimization
  4. 4.Pair constraint enforcement
  1. 1.Phase 4: Cost Breakdown Analysis
  2. 2.Detailed cost per segment
  3. 3.Emission calculations
  4. 4.Penalty analysis
  1. 1.Phase 5: Schedule Generation
  2. 2.Vehicle scheduling with time windows
  3. 3.Route consolidation
  4. 4.Fleet composition analysis

โš™๏ธ Key Parameters

Schedule Parameters

  • โ€”Start Time: When all vehicles begin operations (default: 09:00)
  • โ€”Gap Time: Minutes between routes on same vehicle (default: 5 min)
  • โ€”Max Operation Time: Maximum vehicle operation duration (default: 90 min)

Vehicle Constraints

  • โ€”Max Drones: Maximum number of drone vehicles (default: 6)
  • โ€”Max Pair Duration: Combined time limit for drone pairs (default: 90 min)
  • โ€”Service Time: Service time per customer (default: 2.5 min)

Objective Function Weights

  • โ€”Fixed Cost: Weight for fixed vehicle costs (default: 0.01)
  • โ€”Variable Cost: Weight for distance-based costs (default: 0.01)
  • โ€”Labour Cost: Weight for time-based costs (default: 0.01)
  • โ€”Emissions: Weight for emission costs (default: 0.92) โญ

Optimization Parameters

  • โ€”Number of Bees: Population size (default: 10)
  • โ€”Max Iterations: Optimization iterations (default: 1000)

๐Ÿ“ˆ Outputs

Data Files

  • โ€”Cost_Breakdown.xlsx: Detailed cost analysis per route
  • โ€”Vehicle_Schedule.xlsx: Complete schedule with departure times
  • โ€”Vehicle_Statistics.xlsx: Fleet composition summary
  • โ€”Best_BA_Solution.xlsx: Optimal solution details

Visualizations

  • โ€”Vehicle_Ratio_Chart.png: Fleet composition bar chart
  • โ€”Route_Map.html: Interactive route visualization

Analysis

  • โ€”Cost breakdown by vehicle type
  • โ€”Emission analysis (kg COโ‚‚)
  • โ€”Pair constraint compliance
  • โ€”Schedule feasibility report

๐Ÿš€ How to Use

  1. 1.Select City: Choose Southampton or Portsmouth
  2. 2.Configure Parameters: Adjust optimization settings
  3. 3.Run Optimization: Click "Run Optimization" button
  4. 4.View Results: Check Results and Visualizations tabs
  5. 5.Download Files: Get all output files from Download tab

๐Ÿ”ฌ Technical Details

Vehicle Types

  • โ€”Bike: Capacity 0kg, Cost ยฃ3.15 + ยฃ1.15/mile
  • โ€”Van-D1: Capacity 300kg, 90 min max time, Depot 1
  • โ€”Van-D2: Capacity 300kg, 53 min max time, Depot 2
  • โ€”Drone: Capacity 75kg, 55 min max time, Zero emissions

Algorithms

  • โ€”P-Hub Allocation: Hub location and customer assignment
  • โ€”TSP Domino: Tour construction for customer sequence
  • โ€”Bees Algorithm: Metaheuristic for route optimization
  • โ€”Foraging: Neighborhood search operators

Constraints

  • โ€”Vehicle capacity limits
  • โ€”Time window constraints
  • โ€”Drone pair duration limits (90 min combined)
  • โ€”Single customer per drone route

๐Ÿ“š Research Context

This system is designed for last-mile delivery electrification research, focusing on:

  • โ€”Carbon emission reduction
  • โ€”Multi-modal transportation optimization
  • โ€”Sustainable urban logistics
  • โ€”Digital twin technology for transport decarbonization

๐Ÿ› ๏ธ Technology Stack

  • โ€”Python 3.8+
  • โ€”Gradio: Web interface
  • โ€”Pandas: Data processing
  • โ€”NumPy: Numerical computations
  • โ€”Folium: Interactive mapping
  • โ€”Matplotlib: Visualization
  • โ€”Gurobi (optional): Advanced optimization

๐Ÿ‘จโ€๐Ÿ”ฌ Author

Developed at Heriot-Watt University for Transit Research and Transport Decarbonization.

๐Ÿ“„ License

MIT License

๐Ÿค Acknowledgments

  • โ€”CLD1 and CLD3 Project Partners
  • โ€”Industry collaborators (DHL)
  • โ€”Heriot-Watt University

Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference