海啸淹没制图 | Tsunami Inundation Mapping
Bathtub inundation modeling based on a DEM with hydrological connectivity constraints — only depressions 8-connected to the coastal seed region are flooded; isolated inland basins remain dry even when their elevation is below the water level. Outputs include the inundation extent, water depth (water level − elevation, always non-negative), arrival time from the coast (Euclidean distance × pixel size / wave speed), and critical evacuation zones (dry land below the safety margin that is not flooded). Both the inundated area and water depth are monotonically non-decreasing with water level.
Dependencies / 依赖
pip install numpy rasterio scipy
Usage / 使用方法
Basic Usage (Synthetic Data, Offline)
python geoskill-tsunami-inundation-mapping.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out
More Examples
python geoskill-tsunami-inundation-mapping.py --bbox 120 30 121 31 --synthetic --output-dir ./out
python geoskill-tsunami-inundation-mapping.py --input dem.tif --water-level 15 --output-dir ./out
python geoskill-tsunami-inundation-mapping.py --bbox 120 30 121 31 --water-level 20 --wave-speed 8 --synthetic --output-dir ./out
python geoskill-tsunami-inundation-mapping.py --bbox 121 31 122 32 --synthetic --quiet --output-dir ./out
Output / 输出
| File | Format | Description |
|---|---|---|
inundation.tif |
GeoTIFF | Inundation extent mask |
water_depth.tif |
GeoTIFF | Flood water depth (m, ≥0) |
arrival_time.tif |
GeoTIFF | Tsunami arrival time (s) |
evacuation_zone.tif |
GeoTIFF | Recommended evacuation zone (mutually exclusive with the inundated area) |
tsunami_params.json |
JSON | Parameters such as water level / wave speed / pixel size |
Each run also produces output-manifest.json (run manifest, including inputs / products / QA summary).
Data Source / 数据源 / Source
Real mode reads a single-band DEM GeoTIFF (in meters); synthetic mode generates coastal terrain offline (including ridges and isolated depressions).
Privacy / 隐私声明 / Privacy
- Runs offline by default;
--syntheticmode requires no network at all. - All processing is done locally; user data is never uploaded.
License / License
MIT
name: geoskill-tsunami-inundation-mapping description: 'Bathtub水文连通淹没建模,输出水深、到达时间与撤离区'
海啸淹没制图 | Tsunami Inundation Mapping
基于 DEM 的 bathtub 淹没建模，并加入水文连通约束——只有与海岸种子区 8-连通的洼地才会被淹，孤立内陆盆地即使高程低于水位也不淹没。输出淹没范围、水深（水位-高程，恒非负）、到海岸的到达时间（欧氏距离×像元尺寸/波速）以及临界撤离区（未淹但低于安全余量的干地）。淹没面积与水深均随水位单调不减。
依赖
pip install numpy rasterio scipy
使用方法
基本用法（合成数据，离线）
python geoskill-tsunami-inundation-mapping.py --bbox 116.0 39.0 117.0 40.0 --synthetic --output-dir ./out
更多示例
python geoskill-tsunami-inundation-mapping.py --bbox 120 30 121 31 --synthetic --output-dir ./out
python geoskill-tsunami-inundation-mapping.py --input dem.tif --water-level 15 --output-dir ./out
python geoskill-tsunami-inundation-mapping.py --bbox 120 30 121 31 --water-level 20 --wave-speed 8 --synthetic --output-dir ./out
python geoskill-tsunami-inundation-mapping.py --bbox 121 31 122 32 --synthetic --quiet --output-dir ./out
输出
| 文件 | 格式 | 说明 |
|---|---|---|
inundation.tif |
GeoTIFF | 淹没范围掩膜 |
water_depth.tif |
GeoTIFF | 淹没水深（m，≥0） |
arrival_time.tif |
GeoTIFF | 海啸到达时间（s） |
evacuation_zone.tif |
GeoTIFF | 建议撤离区（与淹没区互斥） |
tsunami_params.json |
JSON | 水位/波速/像元尺寸等参数 |
每次运行还会产出 output-manifest.json（运行清单，含输入/产物/QA 摘要）。
数据源 / Source
真实模式读取单波段 DEM GeoTIFF（单位 m）；合成模式离线生成海岸地形（含山脊与孤立洼地）。
隐私声明 / Privacy
- 默认离线运行，
--synthetic模式完全无网络。 - 所有处理在本地完成，不上传任何用户数据。
License
MIT