305 lines
7.2 KiB
Markdown
305 lines
7.2 KiB
Markdown
# 水体提取与洪涝灾害分析设计
|
||
|
||
更新日期：2026-05-14
|
||
|
||
## 1. 设计结论
|
||
|
||
这个模块不应该被设计成一堆遥感处理工具的集合。它的业务目标很简单：
|
||
|
||
```text
|
||
提取水体 -> 检测洪涝 -> 套合已有矢量数据 -> 输出结果
|
||
```
|
||
|
||
因此前端和后端都应围绕这条流水线组织，而不是暴露过多工程阶段。用户关心的是：
|
||
|
||
- 哪些数据可以拿来提水体。
|
||
- 哪两期数据可以用来判断洪涝。
|
||
- 洪涝范围在哪里、面积多大。
|
||
- 影响了哪些灾害点、行政区、AOI 或其他矢量对象。
|
||
- 结果能不能上图、导出、形成报告。
|
||
|
||
## 2. 当前真实边界
|
||
|
||
现有代码不能理解为已经具备多源 ENVI 洪涝系统。
|
||
|
||
当前事实：
|
||
|
||
- LT-1 有 `SARsImportLuTan1` 相关 ENVI/SARscape 链路，可作为第一条精密检测主线。
|
||
- GF3 有纯 Python/GDAL 的 L1A 到 L2 处理，不是 ENVI/SARscape 洪涝导入。
|
||
- Sentinel-1 有源产品、ZIP/SAFE、EOF、PyINT/Gamma 相关管理设计，不是 ENVI/SARscape 洪涝导入。
|
||
- 当前 `water` 模块已经有旧的单景 geocode、Otsu 快速检测、精密洪涝检测和地图预览能力，可作为迁移基础。
|
||
|
||
所以第一阶段不能承诺 GF3/Sentinel-1 可直接做 ENVI 精密洪涝检测。页面上必须显示为“待接入导入适配器”。
|
||
|
||
## 3. 产品信息架构
|
||
|
||
左侧一级入口合并为：
|
||
|
||
```text
|
||
洪涝灾害分析
|
||
├─ 洪涝灾害分析
|
||
└─ 水体监测（旧入口）
|
||
```
|
||
|
||
新的“洪涝灾害分析”工作台只保留四个视图：
|
||
|
||
```text
|
||
1. 水体提取
|
||
2. 洪涝检测
|
||
3. 套合分析
|
||
4. 结果与任务
|
||
```
|
||
|
||
旧“水体监测”入口短期保留，承载当前 `WaterMonitorPanel` 的功能。后续功能成熟后再逐步迁入新工作台。
|
||
|
||
## 4. 地图设计
|
||
|
||
不新建第二套地图。
|
||
|
||
当前中间地图大屏已经有底图、行政区定位、导出、雷达覆盖、洪涝影像叠加能力。新工作台应复用 `AppMapWorkspace` 和 `App.jsx` 中的 Leaflet 实例，通过回调控制图层：
|
||
|
||
```text
|
||
FloodAnalysisWorkspace
|
||
-> onShowSourceSceneOnMap
|
||
-> onShowFloodOnMap
|
||
-> onToggleFloodLayer
|
||
```
|
||
|
||
地图只负责展示，业务按钮放在左侧工作台。
|
||
|
||
## 5. 流水线设计
|
||
|
||
### 5.1 水体提取
|
||
|
||
目标：把单期雷达影像处理成水体范围。
|
||
|
||
用户动作：
|
||
|
||
- 选择数据。
|
||
- 查看数据是否可处理。
|
||
- 提交水体提取。
|
||
- 查看水体范围。
|
||
- 加载到地图。
|
||
|
||
数据状态建议：
|
||
|
||
- `已入库`：系统只管理了原始/解压数据。
|
||
- `可提取`：已有可用处理器。
|
||
- `处理中`：任务正在运行。
|
||
- `已提取`：已有水体范围产品。
|
||
- `待接入`：数据存在，但缺少对应导入/处理适配器。
|
||
|
||
传感器边界：
|
||
|
||
- LT-1：优先接旧 ENVI/SARscape 链路。
|
||
- GF3：待补 ENVI/SARscape 洪涝导入；现有 Python/GDAL 成果可作为后续快速路线输入。
|
||
- Sentinel-1：待补 ENVI/SARscape 洪涝导入，或后续明确非 ENVI 检测路线。
|
||
|
||
### 5.2 洪涝检测
|
||
|
||
目标：比较灾前/灾后水体变化，识别新增水体作为洪涝范围。
|
||
|
||
用户动作：
|
||
|
||
- 选择灾前数据。
|
||
- 选择灾后数据。
|
||
- 自动推荐配对。
|
||
- 提交洪涝检测。
|
||
- 查看洪涝面积和稳定水体面积。
|
||
- 加载灾前、灾后、分类图到地图。
|
||
|
||
检测路线：
|
||
|
||
- 精密路线：ENVI/SARscape `SARsBasicFeFloodingClassification`。
|
||
- 快速路线：Otsu/GeoTIFF 水体掩膜差异，作为轻量能力。
|
||
|
||
输出类别：
|
||
|
||
```text
|
||
1 = 稳定水体
|
||
2 = 洪涝/新增水体
|
||
3 = 高散射
|
||
4 = 非水体
|
||
```
|
||
|
||
### 5.3 套合分析
|
||
|
||
目标：把洪涝范围与已有矢量数据叠加，回答“影响了什么”。
|
||
|
||
第一阶段套合对象：
|
||
|
||
- 灾害点。
|
||
- 行政区。
|
||
- 当前 AOI。
|
||
- 自定义矢量。
|
||
|
||
输出：
|
||
|
||
- 洪涝范围矢量。
|
||
- 受影响灾害点清单。
|
||
- 行政区/AOI 洪涝面积统计。
|
||
- 距离洪涝范围一定阈值内的风险点。
|
||
- GeoJSON 和表格导出。
|
||
|
||
灾害点关系建议：
|
||
|
||
- `inside_flood`：点落在洪涝范围内。
|
||
- `near_flood`：点距离洪涝边界小于阈值。
|
||
- `inside_scene_only`：点在影像覆盖范围内，但未受洪涝影响。
|
||
|
||
面积统计必须使用合适投影，不能直接用经纬度面积作为正式统计。
|
||
|
||
### 5.4 结果与任务
|
||
|
||
目标：统一查看任务、图层、结果和导出。
|
||
|
||
展示字段：
|
||
|
||
- 结果 ID。
|
||
- 灾前日期。
|
||
- 灾后日期。
|
||
- 卫星组合。
|
||
- 处理器。
|
||
- 洪涝面积。
|
||
- 稳定水体面积。
|
||
- 影响灾害点数量。
|
||
- 状态。
|
||
- 更新时间。
|
||
|
||
操作：
|
||
|
||
- 加载图层。
|
||
- 打开产品包。
|
||
- 导出 GeoTIFF/GeoJSON。
|
||
- 生成报告。
|
||
|
||
## 6. 后端域模型
|
||
|
||
后端可以继续兼容 `/water/*`，但新能力建议逐步进入 `/flood/*`。
|
||
|
||
最小模型不要过度复杂，先围绕四类对象：
|
||
|
||
```text
|
||
WaterExtractionRun
|
||
FloodDetectionRun
|
||
FloodOverlayRun
|
||
FloodResultProduct
|
||
```
|
||
|
||
如果后续需要多源产品治理，再扩展：
|
||
|
||
```text
|
||
FloodReadyProduct
|
||
FloodPair
|
||
FloodVectorAsset
|
||
FloodReport
|
||
```
|
||
|
||
## 7. API 草案
|
||
|
||
### 水体提取
|
||
|
||
```text
|
||
GET /flood/sources
|
||
POST /flood/water-extractions
|
||
GET /flood/water-extractions
|
||
GET /flood/water-extractions/{id}
|
||
GET /flood/water-extractions/{id}/preview
|
||
```
|
||
|
||
### 洪涝检测
|
||
|
||
```text
|
||
POST /flood/pairs/search
|
||
POST /flood/detections
|
||
GET /flood/detections
|
||
GET /flood/detections/{id}
|
||
GET /flood/detections/{id}/preview/{layer}
|
||
```
|
||
|
||
### 套合分析
|
||
|
||
```text
|
||
POST /flood/detections/{id}/vectorize
|
||
POST /flood/detections/{id}/overlay
|
||
GET /flood/detections/{id}/impact
|
||
```
|
||
|
||
### 结果导出
|
||
|
||
```text
|
||
GET /flood/results
|
||
GET /flood/results/{id}
|
||
POST /flood/reports
|
||
```
|
||
|
||
## 8. 前端按钮流
|
||
|
||
### 水体提取
|
||
|
||
- 查询数据。
|
||
- 显示覆盖。
|
||
- 提交水体提取。
|
||
- 批量提取。
|
||
- 查看水体结果。
|
||
|
||
### 洪涝检测
|
||
|
||
- 自动推荐配对。
|
||
- 选择灾前/灾后。
|
||
- 提交检测。
|
||
- MRF 精化开关。
|
||
- 加载图层。
|
||
- 去套合分析。
|
||
|
||
### 套合分析
|
||
|
||
- 运行套合分析。
|
||
- 加载影响点。
|
||
- 导出影响清单。
|
||
- 导出 GeoJSON。
|
||
|
||
### 结果与任务
|
||
|
||
- 刷新结果。
|
||
- 加载全部图层。
|
||
- 打开产品包。
|
||
- 生成报告。
|
||
- 导出成果。
|
||
|
||
## 9. 分阶段实施
|
||
|
||
### Phase 1：前端流水线壳层
|
||
|
||
- 合并“水体监测”和“洪涝灾害分析”为一个业务组。
|
||
- 新工作台只保留水体提取、洪涝检测、套合分析、结果与任务。
|
||
- 复用旧 `/water/*` 数据展示当前已有能力。
|
||
- 明确 GF3/Sentinel-1 为待接入，不显示为可精密检测。
|
||
|
||
### Phase 2：LT-1 主线打通
|
||
|
||
- 把当前 `water_service.py` 中 LT-1 ENVI 链路整理成清晰的水体/洪涝任务。
|
||
- 输出标准结果。
|
||
- 完成地图预览和结果列表。
|
||
|
||
### Phase 3：套合分析
|
||
|
||
- 分类栅格转洪涝矢量。
|
||
- 接入灾害点套合。
|
||
- 接入行政区/AOI 统计。
|
||
- 输出影响清单。
|
||
|
||
### Phase 4：多源扩展
|
||
|
||
- GF3 ENVI/SARscape 导入适配器或替代检测路线。
|
||
- Sentinel-1 ENVI/SARscape 导入适配器或替代检测路线。
|
||
- 多源配对策略和质量提示。
|
||
|
||
## 10. 设计原则
|
||
|
||
- 页面按业务问题组织，不按算法步骤堆控件。
|
||
- 数据已入库不代表可检测，必须明确可用性状态。
|
||
- 地图只保留一套，避免图层和状态重复。
|
||
- 旧 `water` 模块保留迁移期入口，但新功能进入 `FloodAnalysisWorkspace`。
|
||
- 套合分析是核心能力，不是结果页上的附属按钮。
|