SuperAPI AI 工具集

earth2studio-data-fetch

数据与分析

查看项目

更新于 10-16 03:49

技能介绍

用途:指导用户使用 Earth2Studio 数据源 API 下载天气/气候数据。流程为:先从请求中提取变量、时间、数据类型、预报时效、区域与输出格式(追问不超过 3 个问题),再依据分析/预报数据源文档缩小候选数据源,并通过 lexicon(base.py 与各源 lexicon 文件)核验目标变量是否受支持,最后生成返回 xarray DataArray 的抓取脚本。

主要能力:区分分析与预报数据源;对比时间覆盖、空间分辨率、更新频率等差异;按 lexicon 的 VOCAB 映射确认变量可用性(如 GFS、HRRR、ARCO/CDS/WB2ERA5 等)。

使用方式:分析方法为 ds(time, variable) -> xr.DataArray;预报方法为 ds(time, lead_time, variable) -> xr.DataArray。编写脚本前需获取对应数据源文档确认构造函数参数与调用签名,脚本含导入、注释及结果检查(print(data)、data.shape、data.coords),可按需保存文件。首次抓取后数据经 EARTH2STUDIO_CACHE 本地缓存。

前提条件:已安装 Earth2Studio(uv pip install earth2studio 或等效方式)、具备对远程存储(GCS、S3、CDS API 等)的网络访问、CDS 类数据源需配置 ~/.cdsapirc 中的 CDS API key、Python 3.10+。

限制:所有数据源均需联网;不支持本地文件加载(本地 NetCDF/Zarr 应直接用 DataArrayFile/DataSetFile);单个脚本不能混用分析与预报数据源;各源变量覆盖不同,须经 lexicon 核验;CDS API 存在排队限流,GCS/S3 通常更快。变量不在 lexicon 会报 KeyError,时间不可用会报 FileNotFoundError/404。