forecast/forecast-algorithm/ultra_short_term

三场站超短期光伏模型 · E10-A 核心交付包

版本：2026-10-14。统一 MSPF-PV-GRU-LightGBM-Huber 架构，三站独立参数。

核心内容

文件/目录	用途
models/	三站各一份.pt和.joblib，以及锁定E10-A的加载清单；全部需要保留
pv_forecast/	必需推理与预处理代码；模块路径用于模型反序列化，请勿改名
configs/sites.yaml	场站经纬度、海拔和归一化容量
deployment_config.json	模型运行规则
input_schema.json	输入列顺序及场站映射
requirements.txt	运行依赖
docs/输入输出与接入说明.md	数据处理及接口说明
SHA256SUMS.json	文件完整性校验

使用

Python 3.10，推荐Ubuntu 22.04/WSL2。先安装requirements.txt中的依赖，再安装与机器匹配的PyTorch；已验证版本为torch 2.12.1+cu132，CPU推理可运行，不强制使用GPU。本次未另建环境验证依赖安装过程。

from pathlib import Path
from pv_forecast.mspf_pv.inference import predict_selected_arrays

root = Path('/path/to/PV_E10A_20261014_core')
prediction_pu = predict_selected_arrays(
    root, 'beiliu', power_history, future_raw, elevation, device='cpu'
)
prediction_kw = prediction_pu * 3000

请从本包根目录运行，或将根目录加入Python模块搜索路径。以上是接入示例，三个输入数组须由接入层构造，详见docs。调用predict_selected_arrays，不要调用默认指向旧E0的predict_arrays。

• 历史输入：[N,48,7]，48个5分钟点，约4小时；包含实测功率和太阳几何派生量。
• 未来输入：[N,16,20]，采用起报前可获得的EC预报以及目标时刻太阳/时间特征。
• 输出：[N,16]，t+15至t+240min；乘容量得到kW。
• YUWEI/beiliu：3000kW；JMJD01/jiangmen：4050kW；ZHONGXIN/qingyuan：2250kW。
• EC：00/12UTC最新可用批次，实验假设init+8h可用；生产还须确认实际接收。
• 现有输出规则：太阳高度角<-3°置0，裁剪到[0,1.15]标幺。

本包为历史功率+EC版本E10-A，不是纯历史功率版本。不含训练数据、历史实验、样例、测试集或系统调度服务。权重未重训；仅移除非运行内容和训练函数，推理/预处理保留原实现。完整验收历史不计入新的未查看测试结果。