用途:维护或迁移使用 RockHound 的旧项目,处理地球科学数据集(如 PREM)的下载、缓存与加载器。RockHound 仓库已于 2022 年归档并推荐 Ensaio,但不存在 fetcher 名称与返回对象的通用一一映射,因此需在保留可用旧环境的同时评估受支持的替代方案。
主要能力与用法:先检查现有工作流,确认具体的 fetcher、数据版本、来源 URL/哈希、缓存位置、解析器与科学约定;如需独立缓存,应在导入 RockHound 前设置 ROCKHOUND_DATA_DIR。切勿为测试迁移而删除用户缓存。旧版 PREM 加载示例使用上游注册表,可能从 EarthScope/IRIS 下载,加载的是 1 秒 PREM 径向地球模型而非本地野外观测;该注册表 URL 在 2026-09-14 检查时返回 HTTP 404,因此该示例目前需要已有经哈希校验的缓存或另行验证的来源,并非可成功全新下载的配方。测试套件使用明确合成的缓存夹具运行真实加载器,不声称完成 PREM 验证。
迁移步骤:寻找受维护的数据集发布、其再分发许可与不可变标识符;若 Ensaio 无匹配数据集,应使用有文档的 Pooch 注册表与原始提供方,而非替换为无关样本数据。比较下载哈希或记录发布变更,检查单位、网格配准、坐标、缺失值与来源预处理。适配返回契约:Ensaio 路径仍需 CSV/NetCDF 读取器,而 RockHound 可能返回 DataFrame 或 xarray 对象。替换导入前验证代表性数值与下游结果。诊断失效的旧 URL,不要绕过 TLS 或校验和检查。
限制:PREM 表含不连续面及不同的垂直/水平速度,需保留重复边界半径并显式选择插值侧;流体区零剪切速度是有意义的值而非缺失值;不要将完整径向模型直接送入平面层面波求解器。