reki#

reki 是一个用于查找、读取、查询和处理气象数据的 Python 工具库。

reki 当前主要支持 GRIB2 格式数据,通过统一的 source → reader → field query 模型定位数据、查询元数据,并在需要时将选定 字段转换为 xarray.DataArray。

reki 提供以下功能:

  • 从 GRIB2 文件中加载要素场,支持按参数、层次、起报时间、预报时效和其他 GRIB 键进行筛选;

  • 通过各自的 reader 读取 NetCDF、GrADS 和表格文件;NWPC 观测表格保留兼容函数;

  • 支持探索 GRIB2 文件元数据;

  • 提供区域截取、站点采样和网格插值等功能;

  • 支持在中国气象局国家级气象超算平台 (CMA-HPC2023) 访问业务系统本地文件 (/g3/COMMONDATA);

  • 支持从气象大数据云平台 (CMADaaS) 获取业务系统数据。

快速开始#

先安装 reki,并准备文档使用的冻结测试数据:

准备好 ecmwf_ifs 测试数据后,下面的代码可以选择并加载 2 米温度:

from reki import from_source

with from_source({"kind": "file", "path": "original.grib2"}) as source:
    field = source.sel(native={"grib": {"shortName": "2t"}},
                       level_type="height_above_ground", level=2).one()
    t2m = field.to_xarray(rename="t2m").t2m.squeeze(drop=True)

完整示例见 第一个 GRIB 工作流。

文档导航#

  • 数据查找:查找本地文件、URL、目录和业务数据源;

  • GRIB2 工作流:探索 GRIB 元数据、选择字段、处理层次和时效;

  • 数据处理:区域截取、站点采样和网格插值;

  • 命令行:使用 reki inspect、reki ls 和 reki query;

  • 开发:架构、扩展、贡献和 API 参考。

公共 reki request 本地字段定位与集合读取目前只执行 GRIB;NetCDF、GrADS、 表格和 NWPC 观测表格继续使用各自的 reader 或兼容函数。各格式的查询和输出能力 见 数据加载。

备注

本文档仅使用公开的 ECMWF IFS 数据,由 cemc-oper/cedarkit-test-data 项目制作成小文件数据集。

如果想查看 reki 使用 CEMC 业务系统数据的示例,请访问以下两个使用实际业务系统数据生成的文档: