edit | blame | history | raw

Capabilities

目录编号表示建议研究顺序,不代表运行时依赖关系,也不代表每个目录都是
opengeos/geoai 内置能力。

基于 opengeos/geoai 的能力分层

层级 含义 当前工作区示例
A:直接能力 geoai-py 已有模块或文档直接覆盖 目标检测、分割、分类、变化检测、影像处理/导出
B:生态组合 geoai-py 为核心,再组合地理计算或业务库 空间测量、成果质检、灾害统计、部分三维分析
C:产品业务能力 主要由现有产品后端、规则和数据服务实现 风险规则、航线规划、集群调度、GeoLLM、知识图谱、模型治理

判断一个方向是否属于 GeoAI 项目,要看它是否处理地理空间数据并调用 AI 或
空间分析;判断它是否是 geoai-py 的能力,则必须以该仓库当前源码和文档为准。

实现边界与项目阶段是两个维度

项目需求不能直接拿 A/B/C 当作业务分类。A/B/C 只说明某个结果由哪一层实现:

项目阶段 典型结果 常见实现边界
模型观察 框、类别、掩膜、变化栅格、异常分数 A 或 B
空间与测量 相交、距离、面积、长度、位移、覆盖比例 B;若只是消费结果的服务也可能是 C
事件候选 疑似未戴安全帽、疑似堵塞、疑似边坡变化 C
平台动作 告警、喊话、工单、复飞、任务调度 C

同一个目录如果横跨多个边界,README 必须逐段说明。例如 12-quality-control-refly
中的质量指标计算可属于 B,而自动复飞建议和任务下发属于 C,不能用一个总标签掩盖差异。

项目类别不是任意标签

“人员、安全帽、沟道、堵塞物、裂缝、矿浆渗漏”等类别只有在模型权重、类别映射、
输入传感器和标注规范一致时才能成为可运行选项。控制台应选择登记过的任务预设,
不能把用户填写的任意名称交给不支持该类别的通用模型。

  • 安全帽优先建模为人员与安全帽的检测/实例及关联;03-attribute-classification
    只作为人员裁剪图上的可选二次分类,不替代安全帽目标和关联真值。
  • 排洪沟需要沟道/箱涵口与堵塞物的项目掩膜;当前 02-semantic-mapping 颜色基线
    仅验证栅格到矢量的数据流,不代表已经支持排洪沟类别。
  • RGB 水色或浑浊只能作为异常观察,不能直接输出“矿浆渗漏已确认”。

当前 geoai-py 0.42.0 的直接能力目录见
GEOAI_PY_DIRECT_CAPABILITIES.md。该目录区分
了库可以直接承接的模型产出、需要额外依赖或空间规则的组合能力,以及必须由产品
后端实现的业务能力。

官方依据:

每个能力目录至少包含:

  • README.md: 目标、输入、输出和完成标准。
  • requirements.txt: 公共依赖之外的专属依赖。

开始实现时再增加 src/tests/examples/configs/,避免初期产生大量空目录。