使用注意事项
接入前必读的七条规则,全部来自样例数据实测。
时区
文件内容 date_time 为北京时间,文件名起报时间为 UTC,换算相差 8 小时。详见时间规范。
温度单位
t2m 为开尔文(K),直接按摄氏度使用会偏差 273.15:
python
df["t2m_c"] = df["t2m"] - 273.15气压单位
sp 为帕斯卡(Pa),业务常用百帕(hPa):
python
df["sp_hpa"] = df["sp"] / 100太阳辐射累积量
必须做差分才能得到逐时段辐照度,不可直接当瞬时值使用:
text
W/m² = (末时刻累积值 − 初时刻累积值) ÷ 时段秒数 # 15 分钟步长即 ÷ 900- 夜间累积值保持不变(平台期),可用于判别日出日落时段;
- 在在线体验页可切换两种口径直观查看。
rr 不是降雨量
rr 为反射辐射(地表反射短波),不是降水量,请勿按降水字段接入。样例中它满足 rr ≈ 0.216 × tr,可用作数据核对。
云量越界
云量为 0-1 分数(非百分数),网格插值可能导致轻微越界(样例实测 -0.18 至 1.13),建议截断:
python
df[["lcc", "mcc", "hcc", "tcc"]] = df[["lcc", "mcc", "hcc", "tcc"]].clip(0, 1)新文件整体替换
新起报文件到达后应整体替换旧起报的预报数据,避免混用不同起报时次。按 farm_id + issue 建立分区或版本键即可实现幂等落库。
附:自检清单
| 检查项 | 期望值 |
|---|---|
| 行数 | 1441(15 天 × 96 点/天,含首末时刻) |
| 列数 | 19,顺序与文件格式规范一致 |
| 时间间隔 | 严格 15 分钟等间隔,无跳点无重复 |
| 缺失 | 空字符串表示缺失(样例实测全表无缺失) |
| 辐射单调性 | dr / sr / rr / tr 随时间单调不减 |
| 辐射一致性 | rr ≈ 0.216 × tr;dr + sr ≈ 1.21 × tr |
