Skip to content

sediamembantu/Trade-Disruption-Monitor

Repository files navigation

Trade Disruption Monitor

Monitor and analyze disturbances to Malaysian ports caused by the Iran conflict, focusing on the Strait of Hormuz closure and its cascading effects on global maritime trade.

🎯 Purpose

The Strait of Hormuz has effectively been closed since March 2026 due to the Iran conflict, causing massive disruptions to global shipping. This project monitors how this crisis affects Malaysian ports, which handle 95% of Malaysia's international trade.

📊 Key Features

  • Real-time monitoring of 7 major Malaysian ports
  • Anomaly detection against pre-conflict baselines
  • Economic impact analysis of trade disruptions
  • Visualization dashboard for trends and patterns
  • Alert system for significant deviations

📍 Target Ports

Port Location Trade Share
Port Klang Selangor ~90% of Malaysia's trade
Port of Tanjung Pelepas (PTP) Johor Top 16 global port
Johor Port Johor Container hub
Penang Port Penang Northern gateway
Kuantan Port Pahang East coast trade
Bintulu Port Sarawak LNG hub
Kemaman Port Terengganu Petrochemical

📖 Documentation

🚀 Getting Started

# Install dependencies (uv required)
cd projects/Trade_Disruption
uv sync

# Run data collection manually
uv run python src/monitoring/collector.py

# Generate dashboard
uv run python src/visualization/dashboard.py

# Open dashboard in browser
python generate_dashboard.py --serve

📅 Status

  • Phase: Data Collection & Monitoring
  • Last Updated: 2026-03-13
  • Scheduler: Daily at 9:00 AM (Malaysia time) ✅ Running
  • Data: 2 snapshots collected (41 ports, 35,273 vessels)
  • Next Collection: Tomorrow at 9:00 AM
  • Dashboard: Interactive dashboard available at data/dashboard.html

🔄 Automated Collection

Data is collected daily at 9:00 AM using the workspace scheduler.

  • Logs: /data/.openclaw/workspace/scheduler/scheduler.log
  • Data: /data/.openclaw/workspace/projects/Trade_Disruption/data/raw/
  • Status: Running (PID 605)

Scheduler Control:

# Start/stop/restart scheduler
/data/.openclaw/workspace/scheduler/start_scheduler.sh start|stop|restart|status

See CRON_SETUP.md for scheduling options.


🤝 Contributing

This is a research project. Contributions welcome after initial setup.

📄 License

To be determined.

About

Monitor Malaysian maritime trade disruption from Iran conflict using PortWatch data. Tracks vessel counts at major ports (Klang, PTP, Penang, etc.) to detect anomalies and assess impact.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors