Harmon/insar-management-system-v2

Fork 0

Files

T

Harmon 3474e25839 fix(pyint): integrate LT1 gamma import and coreg fixes

2026-04-30 13:54:49 +08:00

6.2 KiB

Raw Blame History

PyINT/Gamma LT-1 集成维护记录

更新时间：2026-04-30

1. 背景

本轮工作目标是评估并吸收专家提供的 D:\Code\PyINT_LT1 中 LT-1 / Gamma 相关修复，继续推进当前项目内 PyINT / Gamma 的 D-InSAR 生产能力。

已有排查结论见：

docs/PYINT_GAMMA_AB_FINDINGS_20260420.md
docs/PYINT_GAMMA_INTEGRATION_DESIGN_20260418.md

之前 A/B 排查已经确认：当前 PyINT/Gamma 的关键问题主要在 LT-1 导入、DEM 几何和 coreg 前置链路，不是解缠、地理编码或导出问题。并且旧的 rescue/fallback 曾经掩盖真实 coreg 失败，导致流程成功但产物全 0。

2. 专家代码判断

专家目录：

D:\Code\PyINT_LT1

该目录不是完整 PyINT 替代仓库，而是一组 LT-1 专用脚本补丁，主要包含：

down2slc_LT1.py
down2slc_cat_LT1.py
down2slc_LT1_all.py
coreg_gamma.py
coreg_gamma_all.py
generate_rdc_dem.py
makedem_pyint.py
makedem.py
diff/unwrap/geocode 相关脚本

可吸收价值：

修正 LT-1 文件名日期提取偏移。
修正 LT-1 批处理错误日志名。
改善 coreg_gamma.py 中 master/slave 路径、RSLC 路径和 masterDate 选择。
增加 master 日期本身的 RSLC 生成处理。
对多景拼接场景更明确地区分单片 SLC、update SLC 和最终拼接 SLC。

不能整包覆盖的原因：

专家版多个脚本大量使用裸 os.system()，部分命令失败不会立即中断。
当前项目已经收紧失败语义，要求 Gamma 核心命令失败即失败，避免再次出现“假成功、全 0 结果”。
专家版引用 LT1_precision_orbit.py，但该文件不在 D:\Code\PyINT_LT1 中。
当前项目已经有系统级精轨桥接 backend/app/pyint_pipeline/apply_lt1_precise_orbit.py，不应退回到未纳管的外部精轨脚本。
当前 WSL 环境没有 csh/tcsh，不能让 Python 运行链硬依赖 LT1_import_SLC_from_zipfiles1 这类 csh 脚本。

3. 本轮改动范围

本轮只修改 Gamma/PyINT vendored 脚本，不修改 ISCE2 或 ENVI D-InSAR 生产链。

改动文件：

third_party/PyINT/pyint/down2slc_LT1.py
third_party/PyINT/pyint/down2slc_cat_LT1.py
third_party/PyINT/pyint/down2slc_LT1_all.py
third_party/PyINT/pyint/coreg_gamma.py
third_party/PyINT/pyint/generate_rdc_dem.py

4. 已落实策略

4.1 LT-1 日期解析

旧实现使用固定切片 file0[41:48]，会把 20241206 截成 0241206。

本轮改为从文件名中正则提取 20\d{6}，同时兼容 .tar.gz 和 .tiff 输入。

4.2 LT-1 单景导入

保留当前 Python 直接调用 par_LT1_SLC 的方式，不强制依赖 csh。

如果运行环境中存在 par_LT1_SLC_YSLi：

额外生成 .slc.update / .slc.update.par
将 update 参数文件中的 state_vector_* 合回主 .slc.par
同时对 .slc.par 和 .slc.update.par 执行当前项目的精轨桥接

如果运行环境中不存在 par_LT1_SLC_YSLi：

继续使用 par_LT1_SLC 的输出
打印 warning
仍执行当前项目的精轨桥接

当前 WSL/Gamma 环境检查结果：

par_LT1_SLC 可用
SLC_cat_list.py 可用
par_LT1_SLC_YSLi 不可用
csh/tcsh 不可用

因此 par_LT1_SLC_YSLi 必须保持可选，不能作为硬依赖。

4.3 LT-1 多景拼接导入

多景场景改为逐景直接调用 Gamma 导入命令，并明确产出：

<date>_<product>.slc
<date>_<product>.slc.par
可选 <date>_<product>.slc.update
可选 <date>_<product>.slc.update.par

拼接时：

如果所有分片都有 update SLC，则优先用 update SLC tab 调用 SLC_cat_list.py
如果 update SLC 不可用，则回退到普通 SLC tab，并打印 warning
最终 <date>.slc.par 仍会再执行一次当前项目的精轨桥接

4.4 错误日志

down2slc_LT1_all.py 的错误日志从：

down2slc_sen_all.err

修正为：

down2slc_LT1_all.err

这能让运行失败时的阶段日志更准确。

4.5 coreg / DEM masterDate 兜底

coreg_gamma.py 和 generate_rdc_dem.py 增加 masterDate 实际存在性检查：

如果模板中的 masterDate 在 SLC/ 下存在，则照常使用。
如果不存在，则选择最接近的已有 SLC 日期，并打印提示。

coreg_gamma.py 同时增加 master 日期本身处理：

如果 Mdate == Sdate，直接将 master SLC 复制为 master RSLC。
生成 master RSLC 的多视幅度。
不再进入 slave coreg 流程。

5. 保留的安全边界

本轮没有恢复旧 rescue/fallback。

必须继续保留：

Gamma 核心命令失败即失败。
run_lt1_pyint_pipeline.py 的全 0 二进制产物检查。
当前项目的 LT-1 精轨桥接和运行摘要记录。
Task_* 输入资产适配层。

这几个边界是防止 PyINT/Gamma 再次产出“看似成功但科学结果无效”的关键。

6. 已完成验证

已完成静态验证：

python3 -m py_compile \
  third_party/PyINT/pyint/down2slc_LT1.py \
  third_party/PyINT/pyint/down2slc_cat_LT1.py \
  third_party/PyINT/pyint/down2slc_LT1_all.py \
  third_party/PyINT/pyint/coreg_gamma.py \
  third_party/PyINT/pyint/generate_rdc_dem.py

已完成 diff 检查：

git diff --check

已确认本轮 Git 改动只包含 Gamma/PyINT 文件和本维护文档，不涉及 ISCE2 / ENVI 生产链。

7. 后续验证建议

建议用历史失败样例做 A/B：

D:\Task_Pool\DInSAR\Task_260416_Gamma_PyINT\Task_20230602_20230720

重点看：

down2slc_LT1_all.err
coreg_gamma_all.err
SLC/<date>/orbit_bridge_summary.json
pyint_run_summary.json
diff_filt / cor / unw / geo_unw 的 all-zero 检查结果

判断标准：

不能靠 rescue 跳过失败。
coreg 若失败，应明确失败并留下阶段日志。
若流程成功，关键二进制产物不能全 0。
精轨桥接 summary 应覆盖 master/slave 日期。

8. 建议提交

建议和本轮代码一起提交：

git add docs/PYINT_GAMMA_LT1_INTEGRATION_NOTES_20260430.md `
  third_party/PyINT/pyint/coreg_gamma.py `
  third_party/PyINT/pyint/down2slc_LT1.py `
  third_party/PyINT/pyint/down2slc_LT1_all.py `
  third_party/PyINT/pyint/down2slc_cat_LT1.py `
  third_party/PyINT/pyint/generate_rdc_dem.py

git commit -m "fix(pyint): integrate LT1 gamma import and coreg fixes"

6.2 KiB Raw Blame History Unescape Escape