# 三场站超短期光伏模型 · 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。本次未另建环境验证依赖安装过程。

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