用途:引导用户通过 Earth2Studio 数据源 API 下载指定变量与时间的天气/气候数据,识别可用数据源、校验变量支持并生成可运行的获取脚本,输出 xarray DataArray。
主要能力:区分分析/再分析源(如 GFS、HRRR、IFS、ARCO_ERA5、CDS_ERA5、WB2ERA5、NCAR_ERA5、GOES、MRMS、JPSS)与预报源(如 GFS_FX、GEFS_FX、HRRR_FX、IFS_FX、IFS_ENS_FX、AIFS_FX、CFS_FX);通过 lexicon 校验变量是否受支持;对比时间覆盖、空间分辨率与更新频率;生成分析源 ds(time, variable) 或预报源 ds(time, lead_time, variable) 的获取脚本。
使用方式:先明确变量(E2Studio 名称如 t2m、u500、z850、tp、msl)、时间、数据类型、预报时效、区域与输出格式;再查在线文档与 lexicon 确认 API 签名和变量支持;确认数据源后生成脚本,包含导入、注释与结果检查(print(data)、data.shape、data.coords),可选保存文件。首次获取后数据经 EARTH2STUDIO_CACHE 本地缓存。
前提:已安装 Earth2Studio(uv pip install earth2studio 或等效方式)、Python 3.10+、可访问远程数据存储(GCS、S3、CDS API 等);CDS 类源需配置 ~/.cdsapirc。
限制:所有数据源均需联网;不支持本地 NetCDF/Zarr 文件加载(应直接用 DataArrayFile/DataSetFile);单个脚本不能混用分析与预报源;变量可用性因源而异,须经 lexicon 校验;CDS API 有队列限流,GCS/S3 通常更快。
不在范围内:安装、模型选择、推理流程、自定义数据源创建、超出文档描述的数据源认证配置。