docs: consolidate current project documentation
This commit is contained in:
@@ -0,0 +1,246 @@
|
||||
# SBAS-InSAR 当前工作流
|
||||
|
||||
最后更新：2026-05-28
|
||||
|
||||
本文件是当前 SBAS-InSAR 生产和结果管理的事实文档。旧的 ISCE2/MintPy 时序生产、早期 SBAS 设计草案、实验 runbook 和阶段性记录不再作为当前依据。
|
||||
|
||||
## 1. 当前结论
|
||||
|
||||
- 当前 SBAS-InSAR 主线是 Gamma DIFF + IPTA SBAS。
|
||||
- 前端入口在“生产管理”工作台内：
|
||||
- `SBAS-InSAR Production`
|
||||
- `SBAS-InSAR 结果`
|
||||
- 后端入口：
|
||||
- `/api/sbas-insar-production`
|
||||
- `/api/sbas-insar-products`
|
||||
- 旧 `/api/timeseries-production`、旧 `ps_production`、旧 `ps_products` 只作为兼容代码保留，不再作为生产管理主入口。
|
||||
- 专家文档 `LT1_GAMMA_SBAS_逐命令处理流程.docx` 是 Gamma 命令链路来源；系统实现负责把专家脚本组织成可配置、可审查、可重跑的生产流水线。
|
||||
|
||||
## 2. 代码入口
|
||||
|
||||
后端：
|
||||
|
||||
```text
|
||||
backend/app/routers/sbas_insar_production.py
|
||||
backend/app/services/sbas_insar_production_service.py
|
||||
backend/app/routers/sbas_insar_products.py
|
||||
backend/app/services/sbas_insar_catalog_service.py
|
||||
deploy/wsl/runners/gamma_sbas_product_tools.py
|
||||
```
|
||||
|
||||
前端：
|
||||
|
||||
```text
|
||||
frontend/src/ProductionWorkspace.jsx
|
||||
frontend/src/SbasInsarProductionPanel.jsx
|
||||
frontend/src/SbasInsarProductsPanel.jsx
|
||||
frontend/src/api/sbasInsarProducts.js
|
||||
frontend/src/config/appConstants.js
|
||||
```
|
||||
|
||||
启动自维护：
|
||||
|
||||
```text
|
||||
backend/app/main.py
|
||||
-> sbas_insar_catalog_service.bootstrap_catalog_on_startup_clean()
|
||||
```
|
||||
|
||||
## 3. 运行时配置
|
||||
|
||||
核心配置从 `.env` 读取：
|
||||
|
||||
```text
|
||||
GAMMA_SBAS_ENABLED
|
||||
GAMMA_SBAS_RUNTIME_ID
|
||||
GAMMA_SBAS_WSL_DISTRO
|
||||
GAMMA_SBAS_PYTHON
|
||||
GAMMA_SBAS_ENV_SCRIPT
|
||||
GAMMA_SBAS_WORK_ROOT
|
||||
GAMMA_SBAS_PRODUCT_ROOT
|
||||
GAMMA_SBAS_SCRIPT_TEMPLATE_ROOT
|
||||
GAMMA_SBAS_SOURCE_ROOTS
|
||||
GAMMA_SBAS_ORBIT_ROOTS
|
||||
GAMMA_SBAS_DEFAULT_RLKS
|
||||
GAMMA_SBAS_DEFAULT_AZLKS
|
||||
GAMMA_SBAS_DEFAULT_MB_MODE
|
||||
GAMMA_SBAS_DEFAULT_REFERENCE_WINDOW
|
||||
GAMMA_SBAS_STEP_TIMEOUT_SECONDS
|
||||
GAMMA_SBAS_WORKFLOW_TIMEOUT_SECONDS
|
||||
```
|
||||
|
||||
默认工作根：
|
||||
|
||||
```text
|
||||
backend/runtime/sbas_insar_production
|
||||
```
|
||||
|
||||
默认产品根：
|
||||
|
||||
```text
|
||||
D:\production_results\timeseries\sbas
|
||||
```
|
||||
|
||||
## 4. 生产流程
|
||||
|
||||
用户侧推荐顺序：
|
||||
|
||||
1. 在 `SBAS-InSAR Production` 输入行政区，查找候选序列。
|
||||
2. 选择 READY 候选，生成 Stack Manifest。
|
||||
3. 创建计划 Run。
|
||||
4. 提交 `Gamma SBAS Workflow` 后台任务。
|
||||
5. 审查基线和 itab。
|
||||
6. 执行后续 Gamma 阶段。
|
||||
7. 发布产品并抽取监测点。
|
||||
8. 到 `SBAS-InSAR 结果` 查看结果和下载资产。
|
||||
|
||||
当前托管阶段：
|
||||
|
||||
```text
|
||||
prepare_slc
|
||||
baseline_audit
|
||||
coregistration
|
||||
rdc_dem
|
||||
interferograms
|
||||
detrend_atm
|
||||
ipta_timeseries
|
||||
publish_products
|
||||
monitor_points
|
||||
```
|
||||
|
||||
`workflow/jobs` 是主入口，旧的逐阶段接口保留用于兼容、排错和历史 Run 读取。
|
||||
|
||||
## 5. AOI 选栈
|
||||
|
||||
当前页面面向用户显示“生产区域”，不是开发用的中心桶或硬分组。
|
||||
|
||||
发现接口支持：
|
||||
|
||||
```text
|
||||
discovery_mode = strict | aoi
|
||||
admin_region
|
||||
aoi_bbox
|
||||
min_aoi_coverage_ratio
|
||||
min_common_overlap_ratio
|
||||
```
|
||||
|
||||
AOI 模式处理逻辑：
|
||||
|
||||
1. 将行政区解析为 AOI 几何。
|
||||
2. 使用 LT1 元数据 bbox 筛选与 AOI 相交的影像。
|
||||
3. 按观测几何分组：
|
||||
- satellite
|
||||
- satellite_mode
|
||||
- relative_orbit
|
||||
- orbit_direction
|
||||
- imaging_mode
|
||||
- polarization
|
||||
4. 后端内部按 footprint 公共重叠继续做空间聚类。
|
||||
5. 输出日期范围、可用景数、缺精轨数、最大时间间隔、公共重叠和 AOI 覆盖摘要。
|
||||
|
||||
`center_bucket` 和 `receiving_station` 是内部诊断字段，不作为用户生产入口展示。
|
||||
|
||||
## 6. 产物契约
|
||||
|
||||
一次完成的 SBAS Run 是一个结果产品包。核心资产包括：
|
||||
|
||||
```text
|
||||
run_manifest.json
|
||||
stack_manifest.json
|
||||
pair_network.json
|
||||
gamma_command_manifest.json
|
||||
workflow_summary.json
|
||||
product_summary.json
|
||||
quality_summary.json
|
||||
monitor_points_summary.json
|
||||
|
||||
publish/geotiff/los_rate_toward_m_per_year.tif
|
||||
publish/geotiff/los_rate_away_m_per_year.tif
|
||||
publish/geotiff/los_sigma_m_per_year.tif
|
||||
publish/geotiff/los_rate_toward_m_per_year.hls.geo_preview.png
|
||||
publish/geotiff/los_sigma_m_per_year.cc.geo_preview.png
|
||||
publish/vectors/los_rate_points.geojson.gz
|
||||
publish/vectors/los_rate_points_summary.json
|
||||
publish/monitor_points/*_timeseries.png
|
||||
publish/monitor_points/*_timeseries.csv
|
||||
publish/monitor_points/*_metadata.json
|
||||
```
|
||||
|
||||
结果页默认展示：
|
||||
|
||||
- LOS 速率预览图；
|
||||
- LOS sigma 预览图；
|
||||
- 监测点曲线；
|
||||
- 点矢量下载入口；
|
||||
- 产品资产列表；
|
||||
- 行政区、中心点、日期范围、景数和配对数。
|
||||
|
||||
全量点 GeoJSON.gz 只提供下载，前端不渲染全量点。
|
||||
|
||||
## 7. LOS 符号约定
|
||||
|
||||
Gamma `ts_rate` 输出是相位速率，系统同时保留两种 LOS 约定：
|
||||
|
||||
```text
|
||||
los_rate_away_mm_per_year = phase_rate * wavelength / (4*pi) * 1000
|
||||
los_rate_toward_mm_per_year = -phase_rate * wavelength / (4*pi) * 1000
|
||||
```
|
||||
|
||||
默认展示：
|
||||
|
||||
```text
|
||||
LOS toward radar positive
|
||||
```
|
||||
|
||||
即朝向雷达为正，远离雷达为负。该约定接近 Gamma `dispmap` 默认 `sflg=0` 的表达习惯。
|
||||
|
||||
## 8. 结果目录与 catalog
|
||||
|
||||
SBAS 结果 catalog 复用通用结果表：
|
||||
|
||||
```text
|
||||
result_products
|
||||
result_assets
|
||||
result_issues
|
||||
result_catalog_state
|
||||
```
|
||||
|
||||
SBAS catalog 名称：
|
||||
|
||||
```text
|
||||
sbas_insar
|
||||
```
|
||||
|
||||
结果管理接口：
|
||||
|
||||
```text
|
||||
GET /api/sbas-insar-products/catalog-status
|
||||
POST /api/sbas-insar-products/rebuild-catalog
|
||||
GET /api/sbas-insar-products
|
||||
GET /api/sbas-insar-products/{product_id}
|
||||
GET /api/sbas-insar-products/{product_id}/assets/{asset_id}
|
||||
```
|
||||
|
||||
启动时会自动扫描已完成 Run 并维护 catalog 状态。
|
||||
|
||||
## 9. 旧链路状态
|
||||
|
||||
以下内容不再作为当前生产事实：
|
||||
|
||||
- `experiments/isce2_sbas_timeseries`
|
||||
- ISCE2 + MintPy 时序生产链
|
||||
- SARscape SBAS 时序方案
|
||||
- 旧 `ps_production` / `ps_products` 生产页面设计
|
||||
- 旧 `geo_timeseries.h5` 作为当前 SBAS 主产品的设计
|
||||
|
||||
旧代码可保留兼容，但新功能、测试和文档默认围绕 Gamma SBAS 独立生产链路展开。
|
||||
|
||||
## 10. 当前验证基线
|
||||
|
||||
截至 2026-05-28 已验证：
|
||||
|
||||
- Gamma SBAS 实验链路可跑通；
|
||||
- 后端 AOI 候选发现可按行政区返回 READY 候选；
|
||||
- 牡丹江 AOI 可发现超过旧严格分组 7 景上限的候选；
|
||||
- 选中候选可生成 Stack Manifest；
|
||||
- 结果发布支持 GeoTIFF、预览图、监测点曲线和点矢量下载；
|
||||
- 前端生产页和结果页构建通过。
|
||||
Reference in New Issue
Block a user