stilhere4huniid/Mall-of-Zimbabwe-Strategy-Sim

Agent-Based Market Simulator modeling the Mall of Zimbabwe's launch impact (2026-2029) using Geospatial & Financial forecasting. # 🏗️ Harare Retail War Room: 4D Market Simulator **An Agent-Based Simulation (ABS) tool forecasting the competitive impact of the Mall of Zimbabwe on the Northern Harare retail landscape.** ## 🚀 Project Overview This project simulates the retail behavior of **1,000+ AI agents** representing shoppers in Harare. It uses a **Gravity Model** combined with **Behavioral Economics** to predict market share shifts across a 4-year timeline (2026 Construction to 2029 Stabilization). It was designed to answer strategic questions for **WestProp**: * *"How much market share will we steal from Sam Levy's Village upon launch?"* * *"Does a 'Luxury' strategy generate more revenue than a 'Mass Market' strategy?"* * *"How does traffic congestion on Alpes Road affect our catchment area?"* --- ## ⚡ Quick Start ### Prerequisites * Python 3.8+ * Pip ### Installation Steps 1. **Clone the Repository** ```bash git clone github.com cd Harare-Retail-4D-Sim ``` 2. **Install dependencies:** ```bash pip install -r requirements.txt ``` 3. **Run the Simulator:** ```bash streamlit run app.py ``` --- ## 📂 Project Structure ```text Harare-Retail-4D-Sim/ ├── app.py # The Streamlit Dashboard (Frontend Interface) ├── model.py # The Mesa Agent-Based Model (Backend Logic & Math) ├── report_generator.py # The FPDF Engine for generating PDF reports ├── requirements.txt # List of Python dependencies ├── README.md # Project Documentation ├── METHODOLOGY.md # Technical explanation of the simulation logic ├── DOCUMENTATION.md # Detailed documentation of features └── assets/ # Folder containing screenshots and images ``` --- # ⚠️ Disclaimer **Educational and Strategic Use Only** This software is an Agent-Based Simulation (ABS) tool designed for strategic forecasting and scenario planning. 1. **Not Financial Advice:** The revenue projections generated by this tool (e.g., "$45. …