Harmon/insar-management-system-v2

Fork 0

Files

T

Harmon da09ba05cb Add LandSAR cluster worker deployment

2026-06-24 14:10:58 +08:00

24 KiB

Raw Permalink Blame History

LandSAR D-InSAR 与 SBAS-InSAR 服务接入采购需求说明书

编制日期：2026-06-04
适用项目：InSAR 管理系统 v2
重点数据：陆探一号（LT-1 / LuTan-1）SAR 数据
文档用途：供应商技术沟通、采购询价、招标需求编制

1. 项目背景

现有 InSAR 管理系统已经具备雷达影像资产管理、任务队列、生产任务监控、结果目录管理、D-InSAR 结果入库、SBAS-InSAR 结果 catalog、地图预览和结果查询等工程能力。系统侧按“处理器 processor + 工作流 workflow + 结果包 manifest”的方式组织外部算法服务，要求外部服务能够以稳定接口接收任务、返回结构化状态并输出可入库的标准结果。

本次拟采购 LandSAR 服务版中的陆探一号 D-InSAR 与 SBAS-InSAR 两个处理服务模块。服务应以本地部署方式运行在生产服务器上，通过 HTTP API、消息队列 API 或二者结合的方式接收处理任务。业务系统负责选择数据、创建任务、轮询或订阅任务状态、读取结果清单并完成 catalog 入库；LandSAR 服务负责实际算法生产、运行日志、状态输出和结果文件组织。

2. 建设目标

采购目标是获得一套可本地部署、可长期稳定运行、可由现有系统调用的 LandSAR 服务版 API 模块，重点支撑陆探一号 D-InSAR 与 SBAS-InSAR 自动化生产。

核心建设目标如下：

支持陆探一号 D-InSAR 差分干涉生产，产出可入库、可预览、可下载的标准 GeoTIFF 结果。
支持陆探一号 SBAS-InSAR 时序形变生产，产出语义明确、可归档、可预览、可下载的栅格或点矢量结果。
支持 D-InSAR 与 SBAS-InSAR 所需的数据导入、轨道处理、DEM 处理、地理编码和结果发布能力。
提供完整的任务提交、排队、状态查询、日志查询、结果查询、任务取消和错误码机制。
与现有系统任务队列、数据目录、D-InSAR 结果 catalog、SBAS-InSAR 结果 catalog 和前端生产页面集成。
避免业务系统直接维护算法进程、底层授权细节和非结构化运行状态。

3. 系统现状

3.1 现有业务系统

现有系统主要技术栈：

后端：FastAPI / Python。
前端：React / Vite。
任务队列：系统内置任务队列和任务日志表。
数据库：系统已有结果 catalog 和任务状态表。
文件组织：生产结果主要进入 D:\production_results，临时工作目录可配置。

3.2 现有系统接入边界

现有系统侧可提供以下集成条件：

可配置的源数据目录、工作目录、结果目录和 DEM 路径。
可按任务生成 run_id、task_id、job_id 并维护任务日志。
D-InSAR 结果目录支持按 pair/run 组织。
SBAS-InSAR 结果目录支持按 processor/run 组织。
结果 catalog 可按 processor_code、engine_code、profile_code 区分不同处理器。
前端生产页面可根据处理器能力显示不同参数和任务状态。

3.3 当前痛点

D-InSAR 和 SBAS-InSAR 长流程任务需要稳定的异步服务接口。
任务状态、阶段进度、日志和错误原因需要结构化输出。
错误码需要统一，便于系统侧自动诊断和前端展示。
多任务并发、排队、互斥和取消能力需要明确。
SBAS-InSAR 输出语义、质量指标和结果文件组织需要供应商明确说明。
D-InSAR 与 SBAS-InSAR 需要共用统一的 API、任务状态和结果 manifest 规范，降低系统侧维护成本。

4. 采购范围

本次采购范围分为必选能力和可选能力。

4.1 必选能力

LandSAR 本地 API 服务部署授权。
陆探一号 D-InSAR API。
陆探一号 SBAS-InSAR API。
D-InSAR 与 SBAS-InSAR 所需的数据导入、轨道处理、DEM 支持和地理编码能力。
任务队列、任务状态、日志、结果查询、任务取消和错误码接口。
API 调用文档、参数说明、返回值说明和示例代码。
服务部署脚本、启动脚本、停止脚本、健康检查接口。
授权服务部署说明和异常处理说明。
D-InSAR 与 SBAS-InSAR 各至少一组陆探一号样例数据的端到端验收支持。

4.2 可选能力

陆探一号独立预处理 API。
陆探一号 PS-InSAR API。
多任务并发执行能力。
GPU 加速能力。
断点续跑能力。
结果自动发布为标准 GeoTIFF、COG 或瓦片服务。
与第三方消息队列对接能力，例如 RabbitMQ、Redis Stream、Kafka 或 ZeroMQ。

5. 总体架构要求

5.1 部署方式

LandSAR API 服务应部署在本地生产服务器，推荐形态：

InSAR 管理系统
  -> HTTP API / MQ
  -> LandSAR API Service
  -> LandSAR Engine
  -> 本地文件系统结果目录

服务应支持 Windows Server 环境部署，安装目录、工作目录、授权方式和监听端口均应可配置。

5.2 服务访问方式

服务应至少提供一种稳定接口方式：

HTTP REST API，本地端口访问，如 http://127.0.0.1:<port>
或消息队列接口，任务提交后异步回传状态

推荐同时支持：

HTTP API 用于任务提交、状态查询、日志查询、结果查询、健康检查。
消息队列用于长任务异步调度和状态通知。

5.3 任务执行模式

所有生产任务均应采用异步任务模式：

系统提交任务。
LandSAR API 返回 job_id。
系统定期查询状态或接收消息通知。
任务完成后系统读取结果清单并入库。

不建议采用一次 HTTP 请求长期阻塞等待处理完成的模式。

6. 数据范围要求

6.1 支持数据类型

本次重点支持陆探一号：

LT-1A
LT-1B
SLC 产品
HH 极化优先，后续可扩展 HV/VV/VH
同轨、同模式、同区域数据配对和时序处理

6.2 输入数据形态

服务应明确支持以下至少一种输入形态。

优先要求：

原始 LT-1 产品目录或压缩包

同时兼容：

已导入的 LT1*_SLC.xml + LT1*_SLC.tif

对于 D-InSAR，服务应支持输入主影像和辅影像路径。
对于 SBAS/PS，服务应支持输入多景时序数据目录。

6.3 辅助数据

服务应支持以下辅助数据配置：

DEM 文件或 DEM 目录。
精密轨道文件目录。
输出目录。
临时工作目录。
可选 GCP 文件。
可选 GACOS 大气改正文件，若服务支持。

7. 功能需求

7.1 陆探一号支撑性预处理能力

7.1.1 功能目标

支撑性预处理能力用于满足 D-InSAR 和 SBAS-InSAR 生产前的数据导入、轨道处理、多视、地理编码和快视输出需要。若供应商提供独立预处理 API，应可作为后续扩展能力接入系统；若预处理仅作为 D-InSAR/SBAS-InSAR 内部阶段，也应在任务日志、阶段状态和结果 manifest 中体现。

7.1.2 必须支持的处理能力

数据导入。
精密轨道导入或轨道参数更新。
多视处理。
辐射定标或强度图生成。
地形校正、正射校正或地理编码。
输出标准 GeoTIFF。
输出快视图。
输出完整处理日志。

7.1.3 输入参数要求

如提供独立预处理 API，预处理任务应至少支持以下参数：

{
  "job_type": "lt1_preprocess",
  "input_path": "D:/data/LT1/scene",
  "dem_path": "D:/DEM/HeiLongJiang10M_DEM.tif",
  "orbit_path": "D:/orbit_pools/landsar",
  "output_dir": "D:/production_results/landsar_preprocess/<job_id>",
  "work_dir": "D:/LandSAR_Work/api/<job_id>",
  "polarization": "HH",
  "az_looks": 3,
  "rg_looks": 3,
  "geocode": true,
  "orthorectify": true,
  "output_format": "GeoTIFF"
}

7.1.4 输出结果要求

如提供独立预处理 API，预处理任务应输出：

output_dir
|-- manifest.json
|-- logs/
|-- quicklook/
|-- geotiff/
|   |-- intensity_geo.tif
|   |-- amplitude_geo.tif
|   `-- ...
`-- metadata/

GeoTIFF 必须满足：

GDAL 可读。
有 CRS。
有 GeoTransform。
NoData 值明确。
数据类型明确。
可被 QGIS 打开。
可被现有系统用于地图预览和后续洪涝分析。

7.2 陆探一号 D-InSAR API

7.2.1 功能目标

D-InSAR API 用于对两景陆探一号 SLC 数据执行差分干涉处理，输出 LOS 形变、相干性、解缠相位和快视产品。

7.2.2 必须支持的处理能力

主辅影像导入。
精密轨道处理。
配准。
重采样。
干涉图生成。
去平地和地形相位。
Goldstein 或等效滤波。
相干性计算。
相位解缠。
LOS 向形变计算。
地理编码。
结果 GeoTIFF 输出。
处理日志和参数文件输出。

7.2.3 可选处理能力

LOS 转垂直向形变。
GCP 优化。
大气相位改正。
自定义解缠阈值。
自定义滤波参数。

大气相位改正如依赖 GACOS，应明确 GACOS 文件来源、格式和命名规则。不得在无 GACOS 文件时静默启用。

7.2.4 输入参数要求

D-InSAR API 应至少支持以下参数：

{
  "job_type": "lt1_dinsar",
  "master": {
    "xml": "D:/Task_Pool/DInSAR/Task_xxx/Input_Data/master.xml",
    "slc": "D:/Task_Pool/DInSAR/Task_xxx/Input_Data/master.tif"
  },
  "slave": {
    "xml": "D:/Task_Pool/DInSAR/Task_xxx/Input_Data/slave.xml",
    "slc": "D:/Task_Pool/DInSAR/Task_xxx/Input_Data/slave.tif"
  },
  "dem_path": "D:/DEM/HeiLongJiang10M_DEM.tif",
  "output_dir": "D:/production_results/dinsar/<pair_key>/<run_id>",
  "work_dir": "D:/LandSAR_Work/api/<job_id>",
  "az_looks": 3,
  "rg_looks": 3,
  "coh_mask_threshold": 0.3,
  "unwrap_coh_threshold": 0.3,
  "filter_alpha": 0.6,
  "geocode": true,
  "vertical_displacement": false,
  "atmospheric_correction": false
}

7.2.5 输出结果要求

D-InSAR 结果应至少包含：

output_dir
|-- manifest.json
|-- logs/
|-- geotiff/
|   |-- los_displacement.tif
|   |-- coherence.tif
|   |-- unwrapped_phase.tif
|   |-- wrapped_phase.tif
|   `-- vertical_displacement.tif
|-- quicklook/
`-- metadata/

其中 vertical_displacement.tif 如未启用垂直向形变，可不生成。

核心 GeoTIFF 要求：

可被 GDAL/QGIS 读取。
坐标系和仿射变换完整。
单位明确，例如米、毫米或弧度。
NoData 值明确。
方向约定明确，例如朝向雷达为正或远离雷达为正。
输出文件命名稳定，不随 GUI 语言环境变化。

7.3 陆探一号 SBAS-InSAR API

7.3.1 能力定位

SBAS-InSAR 是本次采购的必选服务模块。供应商应明确该模块是否已产品化支持 LT-1，并提供真实样例数据、处理报告、输出文件说明和接口调用示例。

7.3.2 基本要求

SBAS-InSAR API 应至少具备：

多景 LT-1 SLC 输入。
干涉对自动选择。
垂直基线阈值设置。
时间基线阈值设置。
多视参数设置。
相干点或有效像元筛选。
时序形变反演。
LOS 时序或速率产品输出。
编码后栅格产品输出。
完整日志和质量指标输出。

7.3.3 输入参数要求

SBAS-InSAR API 应至少支持以下参数：

{
  "job_type": "lt1_sbas_insar",
  "input_stack": {
    "mode": "task_input_data",
    "path": "D:/Task_Pool/SBAS/Task_xxx/Input_Data"
  },
  "dem_path": "D:/DEM/HeiLongJiang10M_DEM.tif",
  "orbit_path": "D:/orbit_pools/landsar",
  "output_dir": "D:/production_results/timeseries/sbas_landsar/<run_id>",
  "work_dir": "D:/LandSAR_Work/api/<job_id>",
  "az_looks": 3,
  "rg_looks": 3,
  "intf_method": "single",
  "perp_baseline": 200,
  "time_baseline": 300,
  "doppler_baseline": 100,
  "network_type": "delaunay",
  "solve_method": "periodogram",
  "los_output": true,
  "post_raster": true,
  "vector_output": false
}

服务应明确支持以下至少一种多景输入形态：

原始 LT-1 多景产品目录或压缩包列表。
已导入的 LT1*_SLC.xml + LT1*_SLC.tif 多景目录。
LandSAR 服务约定的 Task_*/Input_Data 多景任务目录。

7.3.4 输出结果要求

SBAS-InSAR 结果应至少包含：

output_dir
|-- manifest.json
|-- logs/
|-- geotiff/
|   |-- los_timeseries.tif
|   |-- los_rate.tif
|   |-- quality.tif
|   `-- post_raster.tif
|-- vectors/
|-- quicklook/
`-- metadata/

其中 los_rate.tif、quality.tif、vectors/ 可按供应商算法实际输出调整，但 manifest 必须准确标明每个资产的角色、单位、维度和业务含义。

7.3.5 输出说明要求

供应商必须说明 SBAS 输出文件语义：

输出是累计形变、平均速率还是多波段时序。
单位是米、毫米、弧度还是其他。
正负号方向约定。
多波段时序的日期映射关系。
质量图或相干性图的含义。
参考点或参考区域信息。
干涉网络信息，包括时间基线、垂直基线和选对策略。

在未明确输出语义前，业务系统只按 LandSAR 原始产品归档，不直接标记为业务级年速率产品。供应商如要求系统展示年速率产品，必须明确输出确为年速率图，并提供单位、正负号方向和质量控制说明。

7.4 陆探一号 PS-InSAR API

7.4.1 能力定位

PS-InSAR 作为可选扩展能力。若供应商 API 服务支持，应明确接口成熟度和样例验证情况。

7.4.2 基本要求

如支持 PS-InSAR，应至少具备：

多景 LT-1 SLC 输入。
PS 点选择。
网络构建。
参数估计。
大气/轨道残差处理。
时序形变反演。
点矢量结果输出。
栅格化或可视化输出。
点位时间序列导出。

7.4.3 输出要求

PS-InSAR 输出应至少包含：

PS 点 GeoJSON / Shapefile / CSV。
点位形变速率。
点位时序形变。
质量指标。
参考点信息。
坐标系统说明。

8. API 通用接口要求

8.1 健康检查接口

服务应提供：

GET /health
GET /version
GET /capabilities

返回内容至少包括：

服务状态。
LandSAR 引擎版本。
授权状态。
支持模块列表。
支持数据类型。
当前队列长度。
当前运行任务数量。

8.2 任务提交接口

服务应提供统一任务提交接口：

POST /jobs

{
  "job_id": "string",
  "status": "queued",
  "message": "job accepted"
}

8.3 任务状态接口

GET /jobs/{job_id}

{
  "job_id": "string",
  "job_type": "lt1_dinsar",
  "status": "running",
  "progress": 45,
  "stage": "geocoding",
  "message": "processing geocoding",
  "created_at": "2026-06-04T10:00:00Z",
  "started_at": "2026-06-04T10:01:00Z",
  "updated_at": "2026-06-04T10:30:00Z"
}

8.4 日志接口

GET /jobs/{job_id}/logs

要求：

支持获取完整日志。
支持按 offset 或时间增量获取日志。
日志级别包含 INFO、WARNING、ERROR。
日志中应包含 LandSAR 原始错误信息。

8.5 结果接口

GET /jobs/{job_id}/result

{
  "job_id": "string",
  "status": "completed",
  "output_dir": "D:/production_results/...",
  "assets": [
    {
      "role": "primary_geotiff",
      "path": "D:/production_results/.../los_displacement.tif",
      "format": "GeoTIFF",
      "unit": "m",
      "description": "LOS displacement"
    }
  ],
  "logs": [],
  "metadata": {}
}

8.6 任务取消接口

POST /jobs/{job_id}/cancel

要求：

支持取消排队任务。
支持尽可能安全地中止运行中任务。
被取消任务应有明确状态 cancelled。
不得留下无法再次运行的锁文件或僵尸进程。

9. 状态码和错误码要求

服务必须提供稳定错误码，至少包括：

错误码	含义
LICENSE_UNAVAILABLE	授权不可用
ENGINE_NOT_READY	LandSAR 引擎不可用
INVALID_INPUT	输入参数错误
INPUT_NOT_FOUND	输入文件不存在
DEM_NOT_FOUND	DEM 不存在
ORBIT_NOT_FOUND	精轨文件不存在
UNSUPPORTED_SENSOR	不支持的数据类型
PROCESS_FAILED	处理失败
OUTPUT_MISSING	处理完成但结果缺失
TIMEOUT	任务超时
CANCELLED	用户取消

错误响应应包含：

{
  "error_code": "DEM_NOT_FOUND",
  "message": "DEM file not found",
  "detail": "D:/DEM/xxx.tif",
  "recoverable": true
}

10. 与现有系统集成要求

10.1 任务队列集成

现有系统会将 LandSAR API 服务视为外部处理器。业务系统负责创建本地任务记录，LandSAR API 负责实际生产。

集成流程：

用户提交生产任务
-> 系统创建任务记录
-> 系统调用 LandSAR API
-> LandSAR API 返回 job_id
-> 系统轮询或订阅 job 状态
-> job 完成
-> 系统读取 result assets
-> 系统入库 catalog
-> 前端展示结果

10.2 文件目录集成

建议目录：

D:\LandSAR_Work\api
D:\production_results\landsar_preprocess
D:\production_results\dinsar
D:\production_results\timeseries\sbas
D:\production_results\timeseries\psinsar

LandSAR API 应允许调用方指定：

work_dir
output_dir
log_dir
temp_dir

10.3 结果入库集成

LandSAR API 结果清单应便于系统入库。推荐每个任务输出：

manifest.json

manifest 至少包含：

job_id
job_type
processor_code
input_files
output_files
parameters
start_time
end_time
status
CRS
bbox
unit
NoData
software_version
license_mode

11. 性能和稳定性要求

11.1 并发要求

供应商应明确：

是否支持多任务并行。
最大并发任务数。
不同模块是否互斥。
D-InSAR 与预处理是否可同时执行。
API 服务是否支持排队。

如不支持并发，服务也必须支持内部排队或返回明确的忙碌状态。

11.2 超时要求

建议默认超时：

预处理：6 小时。
D-InSAR：12 小时。
SBAS-InSAR：48 小时。
PS-InSAR：72 小时。

超时后应返回明确状态，并保留日志。

11.3 稳定性要求

服务应支持：

长时间运行。
进程异常退出后自动恢复。
服务重启后查询历史任务。
任务失败后保留工作目录和日志。
任务成功后可按配置清理中间文件。

12. 安全和授权要求

API 服务应支持本机访问限制，默认只监听 127.0.0.1。
如监听局域网地址，应支持 Token 或 API Key。
授权异常应有明确错误码。
授权服务应支持开机自启动或由 API 服务托管启动。
授权有效期、授权模块列表应可查询。

13. 文档和交付物要求

供应商应提供：

API 接口文档。
OpenAPI / Swagger 文档。
参数说明表。
错误码说明表。
部署说明。
授权说明。
示例调用代码，至少包括 Python 示例。
示例数据处理报告。
结果文件格式说明。
运维手册。

14. 验收要求

14.1 支撑性预处理验收

如供应商提供独立预处理 API，使用至少 1 景 LT-1 数据完成预处理，验收项：

API 可提交任务。
任务状态可查询。
日志可查询。
输出 GeoTIFF 可被 GDAL/QGIS 打开。
输出包含 CRS 和 GeoTransform。
系统可读取结果并生成预览。

14.2 D-InSAR 验收

使用至少 1 组 LT-1 主辅影像完成 D-InSAR，验收项：

API 可提交任务。
可输出 LOS 形变 GeoTIFF。
可输出相干性 GeoTIFF。
可输出解缠相位或差分相位产品。
可输出处理日志。
结果可进入现有系统 D-InSAR 结果管理。
任务失败时错误码明确。

14.3 SBAS-InSAR 验收

使用不少于 3 景 LT-1 数据完成 SBAS-InSAR 样例处理。若供应商建议更高的最小景数，应按供应商推荐值提供样例数据和验收结果。

验收项：

API 可提交异步 SBAS-InSAR 任务。
任务状态、阶段进度和日志可查询。
可设置时间基线、垂直基线、多视参数和干涉网络策略。
可输出 LOS 时序、速率、累计形变或供应商算法定义的主产品。
输出结果语义明确，包括单位、正负号方向、日期映射、参考点和质量指标。
输出 GeoTIFF 或点矢量结果可被 GDAL/QGIS 读取。
结果可进入现有系统 SBAS-InSAR 结果 catalog。
任务失败、结果缺失、输入不足、DEM 缺失和授权异常时错误码明确。

14.4 PS-InSAR 可选验收

如采购包含 PS-InSAR：

使用供应商建议的最小 LT-1 数据景数完成 PS 样例处理。
输出结果语义明确。
输出点/栅格产品可被 GIS 软件打开。
系统能归档结果和日志。

15. 供应商需确认问题

请供应商在报价或技术响应中明确回答以下问题：

API 服务是 HTTP、消息队列，还是二者都支持？
API 服务是否可本地离线部署？
默认监听端口是多少，是否可配置？
是否提供 OpenAPI / Swagger 文档？
是否支持 LT-1 原始产品直接输入？
是否支持已导入的 LT1*_SLC.xml + LT1*_SLC.tif 输入？
预处理是否包含正射校正或地理编码？
D-InSAR 输出的 LOS 形变单位和正负号约定是什么？
是否支持垂直向形变？
是否支持 GACOS 或其他大气改正？
SBAS-InSAR 是否已产品化支持 LT-1？最小建议景数是多少？
PS-InSAR 是否已产品化支持 LT-1？
支持的最大并发任务数是多少？
是否支持任务取消？
是否支持断点续跑？
是否支持服务重启后恢复任务状态？
授权服务如何部署，是否支持无加密狗本地授权服务？
授权模块是否区分预处理、D-InSAR、SBAS、PS？
是否提供示例数据和验收报告？
是否提供二次开发技术支持？

16. 采购实施建议

建议采用“两个必选服务模块、分阶段实施验收”的方式推进：

第一阶段：D-InSAR 服务接入

必须交付：

LandSAR API 服务。
LT-1 D-InSAR API。
任务状态、日志、结果和错误码接口。
D-InSAR 示例数据验收。

第二阶段：SBAS-InSAR