Tsunami Simulation

A Rust library for simulating tsunami evacuation scenarios with multiple agent types and behaviors.

Features

Multi-agent simulation with different agent types (Child, Teen, Adult, Elder)
Realistic tsunami wave propagation
Path-finding algorithms for evacuation routes
Shelter occupancy tracking
GeoJSON export for visualization
Configurable simulation parameters

Installation

Add this to your Cargo.toml: [dependencies] tsunami_simulation = "0.1.0"

Usage

Basic example:

rust
use tsunami_simulation::Simulation;
use std::path::Path;
fn main() -> std::io::Result<()> {
// Initialize simulation with grid and population data
let mut simulation = Simulation::new(
"data/grids/default_grid.asc",
"data/population/default_population.asc"
)?;
// Run simulation steps
while simulation.step() {
println!(
"Step: {} Tsunami Index: {}",
simulation.current_step,
simulation.tsunami_index
);
}
// Export results
std::fs::create_dir_all("output")?;
export_agents_to_geojson(
&simulation.agent_data_collector,
"output/step.geojson"
)?;
Ok(())
}

Data Format

The simulation requires two ASCII grid files:

Grid file: Defines terrain, roads, and shelter locations
Population file: Defines initial agent distribution

Output

The simulation generates:

GeoJSON files with agent movements
Shelter occupancy data
Agent statistics
Death counts by agent type

License

This project is licensed under the MIT License - see the LICENSE file for details.

Author

Fabhianto Maoludyo (fabhianto.maoludyo@gmail.com)

Repository

https://github.com/fabhiansan/tsunami_simulation

tsunami_simulation 0.1.1