{"id":28297773,"url":"https://github.com/the-milad-a/smart-grid-simulator","last_synced_at":"2025-09-07T00:41:30.356Z","repository":{"id":291346542,"uuid":"977349382","full_name":"The-Milad-A/smart-grid-simulator","owner":"The-Milad-A","description":"Modular, physics-informed simulation of local smart grids with battery storage, decentralized trading, overload mitigation, and line-loss modeling.","archived":false,"fork":false,"pushed_at":"2025-05-04T02:02:08.000Z","size":3,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-15T06:43:29.338Z","etag":null,"topics":["agent-based-modeling","battery-storage","bayesian-simulation","decentralized-energy","electricity-grid","energy-modeling","modeling","optimization","power-simulation","python","smart-grid","sustainability","systems-engineering"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/The-Milad-A.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-04T01:57:06.000Z","updated_at":"2025-05-04T02:02:11.000Z","dependencies_parsed_at":"2025-05-04T18:15:26.228Z","dependency_job_id":null,"html_url":"https://github.com/The-Milad-A/smart-grid-simulator","commit_stats":null,"previous_names":["the-milad-a/smart-grid-simulator"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/The-Milad-A/smart-grid-simulator","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Milad-A%2Fsmart-grid-simulator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Milad-A%2Fsmart-grid-simulator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Milad-A%2Fsmart-grid-simulator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Milad-A%2Fsmart-grid-simulator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/The-Milad-A","download_url":"https://codeload.github.com/The-Milad-A/smart-grid-simulator/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/The-Milad-A%2Fsmart-grid-simulator/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273983073,"owners_count":25202092,"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","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["agent-based-modeling","battery-storage","bayesian-simulation","decentralized-energy","electricity-grid","energy-modeling","modeling","optimization","power-simulation","python","smart-grid","sustainability","systems-engineering"],"created_at":"2025-05-23T03:17:03.581Z","updated_at":"2025-09-07T00:41:30.308Z","avatar_url":"https://github.com/The-Milad-A.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Smart Grid Simulator\n\nThis project models a modular, physics-informed smart grid system composed of decentralized household agents, each with local power generation, consumption, and battery storage. It simulates energy flows, system balancing, overload responses, and basic market dynamics across a neighborhood-scale power grid.\n\n---\n\n## 🔋 Project Goals\n\n- Simulate real-time power distribution across household agents\n- Model storage, transfer, and loss mechanisms within a local grid\n- Implement overload handling (e.g. dump nodes / fail-safe agents)\n- Capture system behavior under generation/load imbalances\n- Provide a framework to test decentralized energy trading and pricing\n\n---\n\n## 🛠️ Key Features\n\n- Household agents with solar generation, demand profiles, and battery systems\n- Power balancing across agents and with grid connection\n- Resistance-based line loss (Ohmic model)\n- Dump load logic to absorb excess power in overload conditions\n- Hour-by-hour time loop simulation over multiple days\n- Optional pricing/market logic for peer-to-peer energy trades\n- Modular structure for extensibility and experimentation\n\n---\n\n## 🧱 Architecture  \n  \nsmart-grid-simulator/  \n│  \n├── agents/  \n│ ├── household.py # Generation, consumption, battery  \n│ ├── dumpnode.py # Absorbs overload / excess energy  \n│  \n├── network/  \n│ ├── transmission.py # Power flow and resistive losses  \n│  \n├── market/  \n│ ├── pricing.py # Optional pricing logic and P2P trades  \n│  \n├── planner/  \n│ ├── simulate_day.py # Time-loop simulation and event management  \n│  \n├── data/  \n│ └── sample_inputs/ # Example load/gen profiles  \n│  \n├── notebooks/  \n│ └── demo_run.ipynb # Example use and visualization  \n│  \n├── README.md  \n└── requirements.txt  \n  \n  \n---\n\n## 📈 Sample Use Case\n\n- 10 households with hourly solar and consumption profiles\n- Shared local battery capacity or individual storage\n- Hour-by-hour simulation for a 7-day period\n- Visualization of power flow, battery charge, and overload events\n- Optional price signal simulation or peer-to-peer trading activation\n\n---\n\n## 🌱 Future Directions\n\n- Integration of real ISO data (PJM, MISO, CAISO)\n- Bayesian modeling of generation uncertainty (weather-based)\n- Grid frequency \u0026 voltage fluctuation modeling\n- Streamlit dashboard or REST API for grid planning\n- Quantum-inspired optimization integration (AWS Braket)\n\n---\n\n## 📚 Tools \u0026 Technologies\n\n- Python 3.x\n- `pandas`, `numpy`, `matplotlib`\n- Modular class structure\n- Optional: `streamlit`, `plotly`, `boto3` (AWS integration)\n\n---\n\n## 📄 License\n\nMIT License — open for educational and non-commercial adaptation.\n\n---\n\n## ✍️ Author\n\nDeveloped by Milad Alibabaie, with focus on modeling energy systems \u0026 designing infrastructure.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthe-milad-a%2Fsmart-grid-simulator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthe-milad-a%2Fsmart-grid-simulator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthe-milad-a%2Fsmart-grid-simulator/lists"}