Harmon/insar-management-system-v2
0
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ca2dbfc0324f322818e80b8e50f6c268d225c906
insar-management-system-v2/docs/SBAS_INSAR_CURRENT_WORKFLOW.md
T

6.9 KiB
Raw Blame History

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. 代码入口

后端：

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

前端：

frontend/src/ProductionWorkspace.jsx
frontend/src/SbasInsarProductionPanel.jsx
frontend/src/SbasInsarProductsPanel.jsx
frontend/src/api/sbasInsarProducts.js
frontend/src/config/appConstants.js

启动自维护：

backend/app/main.py
  -> sbas_insar_catalog_service.bootstrap_catalog_on_startup_clean()

3. 运行时配置

核心配置从 .env 读取：

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
GAMMA_SBAS_TRIAL_ROOT

默认工作根：

D:\production_runtime\sbas_insar_work

默认产品根：

D:\production_results\timeseries\sbas

GAMMA_SBAS_WORK_ROOT stores heavy, restartable Gamma intermediate data. GAMMA_SBAS_PRODUCT_ROOT stores lightweight catalog/download packages under runs/<run_id>. The result catalog indexes the product root first and keeps the work root only as a compatibility fallback.

4. 生产流程

用户侧推荐顺序：

  1. 在 SBAS-InSAR Production 输入行政区，查找候选序列。
  2. 选择 READY 候选，生成 Stack Manifest。
  3. 创建计划 Run。
  4. 提交 Gamma SBAS Workflow 后台任务。
  5. 审查基线和 itab。
  6. 执行后续 Gamma 阶段。
  7. 发布产品并抽取监测点。
  8. 到 SBAS-InSAR 结果 查看结果和下载资产。

当前托管阶段：

prepare_slc
baseline_audit
coregistration
rdc_dem
interferograms
detrend_atm
ipta_timeseries
publish_products
monitor_points

workflow/jobs 是主入口，旧的逐阶段接口保留用于兼容、排错和历史 Run 读取。

5. AOI 选栈

当前页面面向用户显示“生产区域”，不是开发用的中心桶或硬分组。

发现接口支持：

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 是内部诊断字段，不作为用户生产入口展示。

2026-06-09 修正：候选序列发现不再把 center_bucket 作为 strict 模式的硬分组字段。此前全库查找会按中心点小格拆成大量小序列，1500 景 LT-1 数据里最大候选只有 7 景；现在 strict 和 aoi 都先按同卫星/同模式/同相对轨道/同方向/同极化形成观测组，再按 footprint 公共重叠聚类。实际验证：全库 LT-1 候选从最大 7 景恢复到 32/29/28 景级别；牡丹江 AOI 候选也能返回 32/29/26 景级别。

6. 产物契约

一次完成的 SBAS Run 是一个结果产品包。核心资产包括：

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 约定：

los_rate_away_mm_per_year = phase_rate * wavelength / (4*pi) * 1000
los_rate_toward_mm_per_year = -phase_rate * wavelength / (4*pi) * 1000

默认展示：

LOS toward radar positive

即朝向雷达为正，远离雷达为负。该约定接近 Gamma dispmap 默认 sflg=0 的表达习惯。

8. 结果目录与 catalog

SBAS 结果 catalog 复用通用结果表：

result_products
result_assets
result_issues
result_catalog_state

SBAS catalog 名称：

sbas_insar

结果管理接口：

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 View Git Blame Copy Permalink