{"id":26717773,"url":"https://github.com/kernferm/presfutimpactsim","last_synced_at":"2026-01-07T03:45:12.852Z","repository":{"id":250229598,"uuid":"833858544","full_name":"KernFerm/PresFutImpactSim","owner":"KernFerm","description":"This repository contains a Python simulation model that forecasts political, economic, and social factors under a hypothetical presidency. Users input initial values, and the model simulates their progression through defined interactions and random variations.","archived":false,"fork":false,"pushed_at":"2024-12-06T07:36:47.000Z","size":73,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-27T16:19:58.064Z","etag":null,"topics":["economic-model","forecasting","matplotlib","numpy","political-model","python","scipy","simpy","simulation","social-model"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KernFerm.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-07-25T23:04:54.000Z","updated_at":"2025-02-06T02:42:22.000Z","dependencies_parsed_at":"2024-12-06T08:20:06.808Z","dependency_job_id":"71d9975e-775e-48c1-a788-10e95b99626a","html_url":"https://github.com/KernFerm/PresFutImpactSim","commit_stats":{"total_commits":29,"total_committers":1,"mean_commits":29.0,"dds":0.0,"last_synced_commit":"071a86e7f67f39cabdbfe1d34d9c219f93c41e95"},"previous_names":["kernferm/presidential-future-events-impact-simulation","kernferm/presfutimpactsim"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FPresFutImpactSim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FPresFutImpactSim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FPresFutImpactSim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KernFerm%2FPresFutImpactSim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KernFerm","download_url":"https://codeload.github.com/KernFerm/PresFutImpactSim/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245878929,"owners_count":20687297,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["economic-model","forecasting","matplotlib","numpy","political-model","python","scipy","simpy","simulation","social-model"],"created_at":"2025-03-27T16:20:06.334Z","updated_at":"2026-01-07T03:45:12.817Z","avatar_url":"https://github.com/KernFerm.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Support the Project ⭐\n\nIf you find this project useful, please give it a star! Your support is appreciated and helps keep the project growing. 🌟\n\n\n# 🗳️ Presidential and Future Events Impact Simulation 🌍\n\nThis repository contains a **Python simulation model** that forecasts political, economic, and social factors over a specified period under a hypothetical presidency 🏛️. Users can input initial values for key variables, and the model simulates their progression through defined interactions and random variations 📊.\n\n---\n\n## ✨ Features\n\n- **User-Defined Parameters**: Set initial values for GDP growth rate 📈, unemployment rate 📉, public approval rating 👍👎, legislative success rate 📜, social unrest index 🔥, and immigration rate 🛂.\n- **Flexible Duration**: Simulate any number of years, from short-term to long-term projections 📆.\n- **Detailed Interactions**: Model the relationships between variables to simulate realistic outcomes 🎯.\n- **Enhanced Visualization**: Visualize the results with detailed plots 📊 for each variable over time.\n- **Advanced Libraries**: Utilizes SciPy for scientific computing 🧑‍🔬 and SimPy for discrete-event simulation ⚙️ to provide robust and accurate modeling.\n- **Simulation Logging**: Logs the simulation process for detailed tracking and analysis 📝.\n\n---\n\n### 🐍 Python Versions\n\nTo run the simulation, you'll need Python installed. Choose one of the following versions:\n\n- [**Python 3.11.6**](https://github.com/KernFerm/Py3.11.6installer)\n- [**Python 3.11.9**](https://github.com/KernFerm/Py3.11.9installer)\n- [**Python 3.12.1**](https://github.com/KernFerm/Py3.12.1-installer-batch)\n\n---\n\n## ⚙️ Installation\n\n1. **Clone the repository**:\n\n    ```bash\n    git clone https://github.com/kernferm/presidential-future-events-simulation.git\n    cd presidential-future-events-simulation\n    ```\n\n2. **Run the batch script to install the required dependencies**:\n\n    ```bash\n    install_dependencies.bat\n    ```\n\n    This script will:\n    - ✅ Check if Python is installed.\n    - ✅ Check if pip is installed and attempt to install it if not.\n    - ✅ Install the necessary Python packages: `numpy`, `matplotlib`, `scipy`, and `simpy`.\n    - 📝 Log the installation process to `install_log.txt` for troubleshooting.\n\n---\n\n## 📝 Logging\n\nThe `install_dependencies.bat` script logs each step of the installation process to a file named `install_log.txt` 📄. This log includes:\n\n- Python installation verification.\n- Pip installation verification and installation (if needed).\n- Installation of required Python packages.\n- Success or failure messages for each step ✅❌.\n\nThe `main.py` simulation script logs the progression of the simulation to a file named `simulation_log.txt`. This log includes:\n\n- Initial values for the simulation 🧐.\n- Monthly updates for each time step (GDP growth, unemployment rate, public approval, legislative success, social unrest, and immigration rate) 🗓️.\n\n---\n\n## 🚀 Usage\n\n1. **Run the simulation script**:\n\n    ```bash\n    python main.py\n    ```\n\n2. **Follow the prompts to input values** for the number of years and initial variables:\n\n    ```plaintext\n    Enter the number of years for the simulation: \n    Enter initial GDP growth rate (%): \n    Enter initial unemployment rate (%): \n    Enter initial public approval rating (%): \n    Enter initial legislative success rate (%): \n    Enter initial social unrest index (0-100): \n    Enter initial immigration rate (%): \n    ```\n\n3. The simulation will run for the specified number of years (with monthly steps) and generate plots 📊 showing the progression of each variable over time.\n\n---\n\n## 📊 Example\n\nAfter running the script and inputting initial values, the following plots will be generated:\n\n- **GDP Growth (%)** 📈\n- **Unemployment Rate (%)** 📉\n- **Public Approval (%)** 👍👎\n- **Legislative Success Rate (%)** 📜\n- **Social Unrest Index** 🔥\n- **Immigration Rate (%)** 🛂\n\nThese plots provide a visual representation of the simulated impacts of the hypothetical presidency on the various factors over the specified period 🏛️.\n\n---\n\n## 💡 Contributing\n\nContributions are welcome! If you have ideas for improving the simulation or adding new features, please open an issue or submit a pull request 🙌.\n\n---\n\n## 📜 License\n\nThis project is licensed under the [MIT License](https://github.com/KernFerm/Presidential-Future-Events-Impact-Simulation/blob/main/LICENSE) 📄. See the LICENSE file for details.\n\n---\n\n### 📝 Notes:\n\n- **User-Defined Parameters**: Customize the simulation with your own initial values for key political, economic, and social factors.\n- **Installation**: Provides step-by-step instructions for setting up the simulation.\n- **Usage**: Explains how to run the simulation and input values.\n- **Logging**: Describes the log files created during installation and simulation for troubleshooting.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fpresfutimpactsim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkernferm%2Fpresfutimpactsim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkernferm%2Fpresfutimpactsim/lists"}