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.
This 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.
- Backend: ASP.NET Core MVC (.NET 8)
- Frontend: HTML5, CSS3, JavaScript, Bootstrap 5
- Mapping: Leaflet.js for interactive maps
- Data: In-memory city database with population data
- Styling: Custom CSS with Bootstrap components
For detailed system architecture, data flow, and component relationships, see ARCHITECTURE.md.
The application follows a clean MVC architecture with:
- Controllers: Handle HTTP requests and orchestrate business logic
- Services: Contain domain-specific calculations and data access
- Models: Define data structures and validation rules
- Views: Present data using Razor templates with interactive JavaScript
- Introduction to the simulation with educational context
- Clear disclaimers about the purpose and nature of the tool
- Navigation to simulation and informational pages
- Interactive map for target selection
- City dropdown with pre-populated major world cities
- Configurable parameters:
- Bomb yield (0.1 to 100,000 kilotons)
- Detonation type (Air burst vs Surface burst)
- Population density considerations
- Interactive map showing multiple impact zones:
- 🔥 Fireball radius - Complete destruction zone
- ☢️ Radiation radius - Lethal radiation exposure area
- 💥 Air blast radius - Structural damage from overpressure
- 🌡️ Thermal radiation - Burns and fire ignition zones
- 🌊 Fallout patterns - Radioactive contamination (surface bursts)
- Death toll calculations based on population density
- Injury estimates by impact zone
- Total affected population statistics
- Environmental impact assessments
- Scientific basis and methodology
- Historical context and references
- Limitations and disclaimers
- Peace advocacy messaging
The calculations are based on:
- "The Effects of Nuclear Weapons" by Samuel Glasstone and Philip Dolan
- Declassified nuclear testing data
- Published academic research on nuclear weapon effects
- Historical data from Hiroshima and Nagasaki
- Fireball radius: R = 90 × Y^(1/3) meters
- Radiation radius: R = 1200 × Y^(1/3) meters (500 rem dose)
- Air blast radius: R = 2200 × Y^(1/3) meters (5 psi overpressure)
- Thermal radiation: R = 3200 × Y^(1/3) meters (3rd degree burns)
Where Y is the yield in kilotons.
- .NET 8 SDK
- Web browser with JavaScript enabled
-
Clone the repository
git clone <repository-url> cd nuclear-war-simulation
-
Build the project
dotnet build
-
Run the application
dotnet run
-
Open in browser Navigate to
https://localhost:7xxx(port will be displayed in console)
To run in development mode with hot reload:
dotnet watch run├── Controllers/
│ ├── HomeController.cs # Home page and about
│ └── SimulationController.cs # Simulation logic and results
├── Models/
│ ├── City.cs # City data model
│ ├── SimulationModel.cs # Input parameters
│ └── SimulationResult.cs # Calculation results
├── Services/
│ ├── CityService.cs # City data provider
│ └── NuclearBlastCalculator.cs # Physics calculations
├── Views/
│ ├── Home/
│ │ ├── Index.cshtml # Landing page
│ │ └── About.cshtml # Educational information
│ ├── Simulation/
│ │ ├── Index.cshtml # Simulation form
│ │ └── Results.cshtml # Results visualization
│ └── Shared/
│ └── _Layout.cshtml # Main layout template
└── wwwroot/
├── css/site.css # Custom styling
└── js/ # JavaScript files
- Leaflet.js for responsive mapping
- Click-to-select target locations
- Real-time coordinate updates
- Multiple overlay circles for different effects
- Mobile-friendly interface
- Bootstrap 5 grid system
- Custom CSS for enhanced styling
- Progressive enhancement
- Client-side and server-side validation
- Input range restrictions
- Error messaging and user guidance
The application includes data for 20 major world cities:
- New York, Los Angeles, Chicago, Houston (USA)
- London (UK), Paris (France), Berlin (Germany)
- Tokyo (Japan), Beijing (China), Moscow (Russia)
- Mumbai, Delhi (India)
- São Paulo (Brazil), Mexico City (Mexico)
- Cairo (Egypt), Istanbul (Turkey)
- Sydney (Australia), Toronto (Canada)
- Seoul (South Korea), Bangkok (Thailand)
Each city includes:
- Geographic coordinates
- Population data
- Population density estimates
This project supports:
- Nuclear disarmament education
- Awareness of nuclear weapon consequences
- Informed public discourse on nuclear policy
- International peace and cooperation efforts
- Educational use only
- No weapons design information
- Focus on consequences, not creation
- Promotes peace and disarmament
- Based on publicly available scientific data
This is an educational project. If you'd like to contribute:
- Focus on educational value
- Maintain scientific accuracy
- Support peace advocacy goals
- Follow responsible disclosure practices
This project is for educational purposes only. Use responsibly and ethically.
- Nuclear Threat Initiative
- International Campaign to Abolish Nuclear Weapons
- Federation of American Scientists
- Bulletin of the Atomic Scientists
"The unleashed power of the atom has changed everything save our modes of thinking and we thus drift toward unparalleled catastrophe." - Albert Einstein