airmosaic-ai

配置、调用与结果检查

English 中文

先阅读方法。配置示例供代理或任务作者理解字段,不是加载器、run-tool 参数文件或已批准任务。

依赖与配置

直接 R 函数需要 sf 与 ggplot2,包括其 GEOS/GDAL/PROJ 和动态列引用依赖。栅格适配另需 terra;Python 函数需要 GeoPandas、Shapely 和 pyproj,制图另用 Matplotlib,栅格另用 Rasterio。geopy/tidygeocoder 是可选服务客户端,不是基础依赖。记录实际版本,不自动安装。

设置 显式决定
语言 选定可用环境后将 language 填为 r 或 python;示例的空值表示待决定
输入版本与标识 固定数据/边界版本、稳定唯一键、获授权个人位置
来源/工作/显示坐标系 核实的来源基准与轴序,适用的计算及显示支撑
关系与歧义 包含/相交/最近邻;保留候选,适用时设最大距离
栅格含义与目标网格 类别/强度/总量,方法、分辨率、原点、范围和缺失掩膜
地图 数值/单位、坐标单位下的单元尺寸、共用色标、导出尺寸/DPI
地理编码 默认关闭,明确服务/端点、隐私类别和当前条款
输出 新的外部项目目录及输入/配置/质量身份

凭据不是配置值。服务客户端按具体接口在调用时使用获授权环境变量或秘密机制,不能将密钥序列化进任务 JSON 或公开 URL。

选择语言路径

路径 入口 当前验证
R R 操作、scripts/r/ 与 examples/r/ 合成数据已检查内存中的匹配、转换及四类图
Python Python 操作、scripts/python/ 与 examples/python/ 已在独立依赖环境检查对应操作
地理编码 来源/服务流程 未注册或实测在线服务

遵循用户指定语言;未指定时按可用环境与适合维护的库选择并记录,不在失败后静默切换。不同路径要对应来源标识、几何、关系/边界规则、坐标系/轴序、数值单位与质量检查。图形不要求逐像素相同,配色实现和点大小单位可能不同,需要时显式提供相同颜色与范围。

结果契约与复用

两条匹配路径均返回 sample_id、matched_id、n_matches、match_status 和 candidate_ids。候选必须完整保留,可采用 JSON 数组或独立候选表,不能截成单值或语言专用的列表字符串。矢量交换可用 GeoPackage 或经审查的 GeoParquet 并保留坐标元数据;文件名与布局由任务决定。

质量记录保留语言/库/引擎版本、输入/结果身份、匹配数量、单位、边界版本、转换设置、缺失和任务有关的覆盖/总量。未做距离或守恒检查不代表零误差。模块没有自动路径加载器、文件导出、栅格重采样器、地理编码服务、run-tool 或 MCP 适配器。

带日期的合成检查记录保存实际依赖版本、检查案例及源码哈希,只说明已检查的环境,不是通用版本锁定或科学验收。

参考相关技能后的改进

GeoMaster 技能的语言/工具矩阵及矢量、栅格等任务分流可供参考。AirMosaic 采用更聚焦的任务契约与两条已实现语言路径;其示例仅作参考,不构成科学保证,这里保留缺失,不将缺失改成零。

本地 R 专业技能与科学制图技能提供了显式函数输入、单位标签、比较色标一致及物理导出尺寸的思路。仅采用相关模式,不依赖个人技能目录,也未安装或整套复制第三方技能。实际空间接口以一手库文档和合成测试核对,不按仓库热度认定正确性。