apac-nwp-forecast-archive
收藏资源简介:
APAC NWP预报存档是一个专门为亚太地区(覆盖日本、台湾、东南亚、澳大利亚及周边陆地,纬度范围-44至46,经度范围92至154)构建的数值天气预报(NWP)历史预报数据集。该数据集旨在支持太阳能应用,其变量选择侧重于辐照度、温度、云量等相关气象要素,且仅包含陆地网格点数据。数据来源于Open-Meteo开放数据平台,并利用其开源工具链进行导出和归档。数据集以每6小时一次的频率,存档来自多个全球和区域天气模型的预报数据,形成了按模型运行初始时间和预报时效组织的完整历史预报记录。这种结构特别适用于需要历史预报数据进行训练和评估的机器学习任务,例如天气预报修正、多模型融合以及太阳能发电预测等,这些信息无法从再分析数据中重建。数据集包含以下主要天气模型:德国气象局(DWD)的ICON模型(分辨率约11公里)、美国国家海洋和大气管理局(NOAA)的GFS模型(分辨率约13公里)、日本气象厅(JMA)的MSM区域模型(分辨率约5公里)以及欧洲中期天气预报中心(ECMWF)的IFS模型(分辨率约25公里)。各模型的运行频率、存储的预报时效(从3天到15天不等)和辐射变量的计算方式(原生值或通过分离模型估算)有所不同。数据以Parquet文件格式存储,采用Hive风格的分区结构(按模型、年份、月份组织),便于高效查询。文件名对应模型运行的初始化时间(UTC)。数据模式中,每一行数据代表一个预报小时内一个陆地网格点的状态。核心字段包括:网格点索引、经纬度坐标、高程、预报有效时间、多种太阳辐射变量(总水平辐照度GHI、直接水平辐照度、漫射辐照度、直接法向辐照度DNI)、2米气温、2米相对湿度、10米风速、地表气压、小时降水量、各层云量百分比,以及模型运行初始化时间和数据抓取时间等元数据。辐射、湿度和云量等字段以整数形式存储以反映源数据的量化精度,而温度、风等字段则保留为浮点数。数据为原始网格值,未进行基于坐标的高程降尺度处理。
The APAC NWP Forecast Archive is a numerical weather prediction (NWP) historical forecast dataset specifically built for the Asia-Pacific region (covering Japan, Taiwan, Southeast Asia, Australia, and surrounding land areas, with latitude range -44 to 46 and longitude range 92 to 154). This dataset is designed to support solar energy applications, with variable selection focusing on meteorological elements such as irradiance, temperature, cloud cover, and includes only land grid point data. The data is sourced from the Open-Meteo open data platform and exported and archived using its open-source toolchain. The dataset archives forecast data from multiple global and regional weather models at a frequency of every 6 hours, forming a complete historical forecast record organized by model run initialization time and forecast lead time. This structure is particularly suitable for machine learning tasks that require historical forecast data for training and evaluation, such as weather forecast correction, multi-model fusion, and solar power generation prediction, which cannot be reconstructed from reanalysis data. The dataset includes the following main weather models: the German Meteorological Service (DWD) ICON model (resolution approximately 11 km), the U.S. National Oceanic and Atmospheric Administration (NOAA) GFS model (resolution approximately 13 km), the Japan Meteorological Agency (JMA) MSM regional model (resolution approximately 5 km), and the European Centre for Medium-Range Weather Forecasts (ECMWF) IFS model (resolution approximately 25 km). The models differ in run frequency, stored forecast lead times (ranging from 3 to 15 days), and the calculation method for radiation variables (native values or estimated via separate models). The data is stored in Parquet file format with a Hive-style partitioning structure (organized by model, year, month) to facilitate efficient querying. File names correspond to the model run initialization time (UTC). In the data schema, each row represents the state of a land grid point for one forecast hour. Core fields include: grid point index, latitude and longitude coordinates, elevation, forecast valid time, various solar radiation variables (global horizontal irradiance GHI, direct horizontal irradiance, diffuse irradiance, direct normal irradiance DNI), 2-meter air temperature, 2-meter relative humidity, 10-meter wind speed, surface pressure, hourly precipitation, cloud cover percentages at different layers, and metadata such as model run initialization time and data fetch time. Fields for radiation, humidity, and cloud cover are stored as integers to reflect the quantization precision of the source data, while fields for temperature and wind are retained as floating-point numbers. The data consists of raw grid values without elevation downscaling based on coordinates.
数据集概述
APAC NWP Forecast Archive 是一个面向亚太区域的数值天气预报(NWP)历史归档数据集,专为太阳能应用场景设计。
核心特征
- 覆盖范围:亚太区域(纬度 −44° 至 46°,经度 92° 至 154°),覆盖日本、台湾、东南亚、澳大利亚及周边陆地,仅包含陆地网格点。
- 时间分辨率:每小时一次预报,每6小时归档一次(不同模型存在差异)。
- 数据来源:基于 Open-Meteo 平台的开源数据分发,使用其工具链导出。
- 数据格式:Parquet 文件,按 Hive 风格分区存储(
model/year/month)。
包含的预报模型
| 模型名称 | 提供方 | 空间分辨率 | 每日运行次数 | 存储预报时长 | 辐射数据来源 |
|---|---|---|---|---|---|
dwd_icon |
德国气象局 (DWD) | 0.125°(约11公里) | 4次 | 7天 | 原生直接辐射和散射辐射 |
ncep_gfs013 |
美国国家海洋和大气管理局 (NOAA) | ~0.117°(约13公里) | 4次 | 7天 | 散射辐射原生,直接辐射通过总辐射减散射辐射计算 |
jma_msm |
日本气象厅 (JMA) | 0.0625°×0.05°(约5公里) | 8次 | 3天(按运行次变化) | 总辐射原生;直接/散射通过分离模型计算 |
ecmwf_ifs025 |
欧洲中期天气预报中心 (ECMWF) | 0.25°(约25公里) | 4次 | 15天(3小时间隔) | 总辐射原生;直接/散射通过分离模型计算 |
特别说明:ecmwf_aifs025_single 模型已于2026年6月13日停止归档(保留已有文件)。JMA MSM 和 APAC 区域 ICON 预报无公开等价替代。
数据字段结构
每个文件代表一个模型的一次初始运行,每行对应一个陆地网格点在一个预报时刻的值。
| 字段名称 | 类型 | 描述 |
|---|---|---|
location_id |
int32 | 网格点在模型网格中的索引 |
latitude, longitude |
float32 | 网格点坐标(度) |
elevation |
float32 | 网格点海拔(米) |
time |
timestamp (UTC) | 预报有效时间 |
shortwave_radiation_wattPerSquareMetre |
uint16 | 太阳总辐射(GHI),前一小时反向平均 |
direct_radiation_wattPerSquareMetre |
uint16 | 直接水平辐射 |
diffuse_radiation_wattPerSquareMetre |
uint16 | 散射辐射 |
direct_normal_irradiance_wattPerSquareMetre |
uint16 | 直接法向辐照度(DNI,太阳高度角<5°时不稳定) |
temperature_2m_celsius |
float32 | 2米空气温度 |
relative_humidity_2m_percentage |
uint8 | 2米相对湿度 |
wind_speed_10m_metrePerSecond |
float32 | 10米风速 |
surface_pressure_hectopascal |
float32 | 地表气压 |
precipitation_millimetre |
float32 | 小时降水量 |
cloud_cover_percentage (+ _low/_mid/_high) |
uint8 | 云量(总云量、低云、中云、高云) |
run_init, scraped_at |
timestamp (UTC) | 模型初始运行时间 / 管道抓取时间(溯源) |
存储结构与文件命名
- 目录布局:
data/model={model_name}/year={yyyy}/month={mm}/{yyyymmddTHH}Z.parquet - 文件名:模型初始运行时间(UTC),如
20260612T00Z.parquet表示2026年6月12日00Z的运行。 - 文件覆盖:同一运行若被多次抓取,新文件覆盖旧文件。
- 时间过滤:仅存储
time >= run_init的数据,因此所有记录的lead_time >= 0。部分文件可能从预报开始后数小时开始(如最小领先时间为3小时)。
注意事项
- 超过模型原生小时分辨率(如ICON >78小时、GFS >120小时)的预报值,Open-Meteo 使用太阳几何感知的晴空指数法(辐射)或 Hermite 插值(其他变量)从3小时间隔插值得到。日总量可靠,但该区间内次3小时云量变化被平滑。
jma_msm的预报时长交替变化(00/12 UTC运行:78小时;其他运行:39小时),文件尾部会出现变长的 NaN 序列。- NaN 尾部出现在请求窗口超过可用预报时长的情况,丢弃 NaN 行可得到干净数据。
- ECMWF 数据集时间步长较粗(3小时/6小时),其他模型为小时级。AIFS 为数据驱动(AI)模型,中长期趋势预测能力强,但场分布较物理模型平滑。
jma_msm存在混合运行现象:文件标签为T03Z可能包含03Z运行的短期预报和上一次00/12 UTC主运行的远期预报。- 2026年6月12日12 UTC之前上传的文件所有字段均为 float32(后期为整数量化)。
使用建议
- 单文件读取:使用
pandas.read_parquet()配合hf://路径。 - 批量筛选过滤:使用 DuckDB 或 PyArrow 通过通配符路径读取,并利用分区列(
model、year、month)及坐标条件进行过滤。
许可与引用
- 数据许可:CC BY 4.0
- 来源归属:需保留 Open-Meteo.com 的归属声明,数据基于 DWD(ICON)、NOAA(GFS)和 JMA(MSM)的开放数据。




