opengis-daf

项目地址： https://github.com/znlgis/opengis-daf

许可证： MIT License

文档： https://github.com/znlgis/opengis-daf/tree/main/docs（快速入门、方案配置指南、算子参考、CLI 参考）

底层依赖： GDAL/OGR 3.x、NetTopologySuite 2.6、Npgsql 10、Serilog 4.3

概述

OpenGIS Data Analysis Framework（简称 OpenGisDAF / daf）是一个方案驱动、纯配置定义的 GIS 数据分析与数据质检框架：用一个 JSON 方案（AnalysisPlan）描述"输入数据 → 算子处理 → 输出目标"的完整流程，可复用、可版本化。核心能力：

• 方案驱动：纯 JSON 定义分析流程，内置 21 条方案校验规则（参数存在性/类型/范围、绑定完整性、DAG 环检测）
• 空间分析：缓冲区、裁剪、相交检查、包含检查、坐标系转换（CRS 全链路传播，Z 值保留）
• 属性操作：字段计算器（表达式 + 算术解析器）、空值填充
• 数据质检：几何有效性、属性完整性检查，QC 模式自动生成质量评分报告
• DAG 调度：Kahn 拓扑排序，upstream 绑定串联算子，超时/重试/失败策略控制
• 多数据源/多输出：IFeatureSource（GeoJSON、Shapefile、PostGIS、内存）× IFeatureSink（控制台、GeoJSON、Shapefile、PostGIS）
• 插件扩展：AssemblyLoadContext 动态加载算子 DLL，插件算子与内置算子在同一 DAG 中无区别
• 方案管理：list/create/copy/export、版本回退、跨版本 Diff、原子写入

环境要求： .NET SDK 10.0（仓库 global.json 已锁定版本）、Git（克隆时需 --recurse-submodules，子模块 opengis-utils-for-net 提供 GDAL 绑定）。Windows x64 / Linux x64 / macOS。

---

快速上手

# 克隆（必须带子模块）
git clone --recurse-submodules https://github.com/znlgis/opengis-daf.git
cd opengis-daf
dotnet build            # 或 .\build.ps1 / ./build.sh

# 验证安装
dotnet run --project src/OpenGisDAF.Cli -- help

# 校验方案（不执行）
daf validate --plan plans/my-analysis.json
# 执行分析/质检
daf run --plan plans/my-analysis.json

测试须分两步（.NET 10 SDK + xunit.v3 工具链下 dotnet test 同命令构建会报"运行了零个测试"并退出码 5）：

dotnet build OpenGisDAF.slnx --configuration Release
dotnet test OpenGisDAF.slnx --configuration Release --no-build

仓库自带完全自包含的学习 Demo（demo/，虚构"新星市"合成数据，一键脚本 demo/run-demo.ps1 / run-demo.sh 依次执行构建 → 算子清单 → 校验 → 4 个方案 → 插件演示，并对退出码断言）。

---

方案配置（核心）

顶层结构

字段	类型	必填	说明
id	string	是	方案唯一标识
name	string	是	方案名称
version	string	是	语义化版本（如 "1.0.0"）
group	string	否	分组名（方案管理分类用）
items	array	是	分析项列表（至少 1 个）
executionPolicy	object	否	failurePolicy: stopOnAny（默认，遇错即停）/ continueIndependent（继续独立项）；maxParallelism 默认 4