{"id":29021415,"url":"https://github.com/arhadnane/nuclear-war-simulation","last_synced_at":"2026-05-17T17:03:36.388Z","repository":{"id":301068531,"uuid":"1006405926","full_name":"arhadnane/Nuclear-War-Simulation","owner":"arhadnane","description":"An interactive web application that simulates the effects of nuclear weapons on urban populations.This educational tool helps users understand the devastating consequences of nuclear warfare through scientifically accurate calculations and visualizations.","archived":false,"fork":false,"pushed_at":"2025-06-25T01:14:53.000Z","size":37,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-06-25T02:25:27.710Z","etag":null,"topics":["aspnet-mvc","blast-simulation","bootstrap","casualty-estimation","csharp","dotnet-8","educational","interactive-maps","leaflet","mapping","nuclear-effects","nuclear-simulation","physics-simulation","scientific-computing","simulation"],"latest_commit_sha":null,"homepage":"","language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/arhadnane.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","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-06-22T07:35:49.000Z","updated_at":"2025-06-25T01:14:56.000Z","dependencies_parsed_at":"2025-06-25T02:25:34.367Z","dependency_job_id":"4dedac24-ee17-47ad-9685-9b4ae419e28c","html_url":"https://github.com/arhadnane/Nuclear-War-Simulation","commit_stats":null,"previous_names":["arhadnane/nuclear-war-simulation"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/arhadnane/Nuclear-War-Simulation","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arhadnane%2FNuclear-War-Simulation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arhadnane%2FNuclear-War-Simulation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arhadnane%2FNuclear-War-Simulation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arhadnane%2FNuclear-War-Simulation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/arhadnane","download_url":"https://codeload.github.com/arhadnane/Nuclear-War-Simulation/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/arhadnane%2FNuclear-War-Simulation/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":276312968,"owners_count":25620626,"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-21T02:00:07.055Z","response_time":72,"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":["aspnet-mvc","blast-simulation","bootstrap","casualty-estimation","csharp","dotnet-8","educational","interactive-maps","leaflet","mapping","nuclear-effects","nuclear-simulation","physics-simulation","scientific-computing","simulation"],"created_at":"2025-06-26T02:05:34.644Z","updated_at":"2025-09-21T21:46:44.190Z","avatar_url":"https://github.com/arhadnane.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Nuclear War Simulation\n\n![Nuclear War Simulation](https://img.shields.io/badge/Purpose-Educational-blue)\n![Framework](https://img.shields.io/badge/Framework-ASP.NET%20Core%208-purple)\n![License](https://img.shields.io/badge/License-Educational%20Use-green)\n\n## 🎯 Project Overview\n\nAn interactive web application that simulates the effects of nuclear weapons on urban populations. This educational tool helps users understand the devastating consequences of nuclear warfare through scientifically accurate calculations and visualizations.\n\n## ⚠️ Important Disclaimer\n\nThis simulation is designed for **educational purposes only**. It aims to promote awareness about the catastrophic consequences of nuclear weapons and support efforts toward nuclear disarmament and world peace. The application is not intended to glorify violence or warfare.\n\n## 🛠️ Technologies Used\n\n- **Backend**: ASP.NET Core MVC (.NET 8)\n- **Frontend**: HTML5, CSS3, JavaScript, Bootstrap 5\n- **Mapping**: Leaflet.js for interactive maps\n- **Data**: In-memory city database with population data\n- **Styling**: Custom CSS with Bootstrap components\n\n## 🏗️ Architecture\n\nFor detailed system architecture, data flow, and component relationships, see [ARCHITECTURE.md](./ARCHITECTURE.md).\n\nThe application follows a clean MVC architecture with:\n- **Controllers**: Handle HTTP requests and orchestrate business logic\n- **Services**: Contain domain-specific calculations and data access\n- **Models**: Define data structures and validation rules\n- **Views**: Present data using Razor templates with interactive JavaScript\n\n## ✨ Features\n\n### 🏠 Home Page\n- Introduction to the simulation with educational context\n- Clear disclaimers about the purpose and nature of the tool\n- Navigation to simulation and informational pages\n\n### 🎯 Nuclear Impact Simulation\n- Interactive map for target selection\n- City dropdown with pre-populated major world cities\n- Configurable parameters:\n  - Bomb yield (0.1 to 100,000 kilotons)\n  - Detonation type (Air burst vs Surface burst)\n  - Population density considerations\n\n### 📊 Results Visualization\n- Interactive map showing multiple impact zones:\n  - 🔥 **Fireball radius** - Complete destruction zone\n  - ☢️ **Radiation radius** - Lethal radiation exposure area\n  - 💥 **Air blast radius** - Structural damage from overpressure\n  - 🌡️ **Thermal radiation** - Burns and fire ignition zones\n  - 🌊 **Fallout patterns** - Radioactive contamination (surface bursts)\n\n### 📈 Casualty Estimates\n- Death toll calculations based on population density\n- Injury estimates by impact zone\n- Total affected population statistics\n- Environmental impact assessments\n\n### 📚 Educational Content\n- Scientific basis and methodology\n- Historical context and references\n- Limitations and disclaimers\n- Peace advocacy messaging\n\n## 🔬 Scientific Accuracy\n\nThe calculations are based on:\n- \"The Effects of Nuclear Weapons\" by Samuel Glasstone and Philip Dolan\n- Declassified nuclear testing data\n- Published academic research on nuclear weapon effects\n- Historical data from Hiroshima and Nagasaki\n\n### Calculation Methods\n- **Fireball radius**: R = 90 × Y^(1/3) meters\n- **Radiation radius**: R = 1200 × Y^(1/3) meters (500 rem dose)\n- **Air blast radius**: R = 2200 × Y^(1/3) meters (5 psi overpressure)\n- **Thermal radiation**: R = 3200 × Y^(1/3) meters (3rd degree burns)\n\nWhere Y is the yield in kilotons.\n\n## 🚀 Getting Started\n\n### Prerequisites\n- .NET 8 SDK\n- Web browser with JavaScript enabled\n\n### Installation\n\n1. **Clone the repository**\n   ```bash\n   git clone \u003crepository-url\u003e\n   cd nuclear-war-simulation\n   ```\n\n2. **Build the project**\n   ```bash\n   dotnet build\n   ```\n\n3. **Run the application**\n   ```bash\n   dotnet run\n   ```\n\n4. **Open in browser**\n   Navigate to `https://localhost:7xxx` (port will be displayed in console)\n\n### Development\n\nTo run in development mode with hot reload:\n```bash\ndotnet watch run\n```\n\n## 🏗️ Project Structure\n\n```\n├── Controllers/\n│   ├── HomeController.cs          # Home page and about\n│   └── SimulationController.cs    # Simulation logic and results\n├── Models/\n│   ├── City.cs                    # City data model\n│   ├── SimulationModel.cs         # Input parameters\n│   └── SimulationResult.cs        # Calculation results\n├── Services/\n│   ├── CityService.cs             # City data provider\n│   └── NuclearBlastCalculator.cs  # Physics calculations\n├── Views/\n│   ├── Home/\n│   │   ├── Index.cshtml           # Landing page\n│   │   └── About.cshtml           # Educational information\n│   ├── Simulation/\n│   │   ├── Index.cshtml           # Simulation form\n│   │   └── Results.cshtml         # Results visualization\n│   └── Shared/\n│       └── _Layout.cshtml         # Main layout template\n└── wwwroot/\n    ├── css/site.css               # Custom styling\n    └── js/                        # JavaScript files\n```\n\n## 🎨 Features in Detail\n\n### Interactive Map Integration\n- Leaflet.js for responsive mapping\n- Click-to-select target locations\n- Real-time coordinate updates\n- Multiple overlay circles for different effects\n\n### Responsive Design\n- Mobile-friendly interface\n- Bootstrap 5 grid system\n- Custom CSS for enhanced styling\n- Progressive enhancement\n\n### Form Validation\n- Client-side and server-side validation\n- Input range restrictions\n- Error messaging and user guidance\n\n## 🌍 City Database\n\nThe application includes data for 20 major world cities:\n- New York, Los Angeles, Chicago, Houston (USA)\n- London (UK), Paris (France), Berlin (Germany)\n- Tokyo (Japan), Beijing (China), Moscow (Russia)\n- Mumbai, Delhi (India)\n- São Paulo (Brazil), Mexico City (Mexico)\n- Cairo (Egypt), Istanbul (Turkey)\n- Sydney (Australia), Toronto (Canada)\n- Seoul (South Korea), Bangkok (Thailand)\n\nEach city includes:\n- Geographic coordinates\n- Population data\n- Population density estimates\n\n## 🕊️ Peace Mission\n\nThis project supports:\n- Nuclear disarmament education\n- Awareness of nuclear weapon consequences\n- Informed public discourse on nuclear policy\n- International peace and cooperation efforts\n\n## ⚖️ Legal and Ethical Considerations\n\n- Educational use only\n- No weapons design information\n- Focus on consequences, not creation\n- Promotes peace and disarmament\n- Based on publicly available scientific data\n\n## 🤝 Contributing\n\nThis is an educational project. If you'd like to contribute:\n1. Focus on educational value\n2. Maintain scientific accuracy\n3. Support peace advocacy goals\n4. Follow responsible disclosure practices\n\n## 📝 License\n\nThis project is for educational purposes only. Use responsibly and ethically.\n\n## 📚 Additional Resources\n\n- [Nuclear Threat Initiative](https://www.nti.org/)\n- [International Campaign to Abolish Nuclear Weapons](https://www.icanw.org/)\n- [Federation of American Scientists](https://fas.org/)\n- [Bulletin of the Atomic Scientists](https://thebulletin.org/)\n\n---\n\n*\"The unleashed power of the atom has changed everything save our modes of thinking and we thus drift toward unparalleled catastrophe.\"* - Albert Einstein\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farhadnane%2Fnuclear-war-simulation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Farhadnane%2Fnuclear-war-simulation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Farhadnane%2Fnuclear-war-simulation/lists"}