Scientific Reports 研究：第三轮时间链、因果控制与外部时段确认复现包

范围与入口
本包是研究证据与实验复现材料，不是期刊录用保证，也不是现场储能测试。
reproduce_round3.py 可从任意工作目录调用；所有输入相对脚本本身定位。
下列示例在本 README 所在目录运行。无需原工作空间、网络或云端账户。
输入、冻结模型、已保存的三组控制结果、统计表和审计记录均在包内。

运行环境
原实验：Python 3.12.14；numpy 2.3.5；scipy 1.17.0；pandas 2.2.3。
scipy.optimize.linprog 使用 SciPy 随附的 HiGHS，不需要商业求解器。
建议在独立虚拟环境安装：
  python -m pip install numpy==2.3.5 scipy==1.17.0 pandas==2.2.3
安装依赖可能需要网络；以下复现计算本身均离线。

一、复算已保存结果的全部统计
  python reproduce_round3.py --analysis-only --output reproduced/analysis_only

该模式逐组读取 archived_conditional、causal_development、confirmation 下
F_FULL、F_BR0、DMPC 已保存的控制结果，重做三类事件、配对差异、
2000 次块自助法、缺供严重度、资源使用和目标匹配 Brier 分数。
它不重新运行控制器。所有新文件写入指定的新空目录。

二、从冻结模型与自包含源数据重算控制结果和统计
  python reproduce_round3.py --recompute --workers 4 --output reproduced/full

顺序为：
1. 用 inputs/calibration_2021.npz 和 causal_inputs/frozen_model.npz 重建
   英国开发输入；程序会独立检查拟合能否复现，但不改写冻结模型。
2. 将同一模型、缩放器和残差库应用于已打包的 AEMO 规范 CSV，
   只导出预先选定的确认期，不在澳大利亚数据上重新拟合。
3. 分别运行三组输入上的全部三个控制器，再补充与目标一致的风险评估。
4. 复算统计并和已保存的科学结果比较。
结果位于 reproduced/full/inputs、results、analysis；每一步日志位于 logs。
完整重算需要明显长于 analysis-only，耗时依赖处理器与并发数。

可先检查路径、冻结哈希和准确命令而不计算：
  python reproduce_round3.py --recompute --dry-run --output reproduced/check

任一已有非空输出目录都会被拒绝；本入口不覆盖归档证据。
execution_manifest.json 记录版本、参数、步骤与返回码；
comparison_to_archived.json 比较科学结果（绝对容差 1e-9、相对容差 1e-8）。
文件路径、ZIP 内部时间和求解耗时不要求字节级相同；若事件计数、
配对差异或其他科学结果不一致，入口会报告失败，保留日志供定位。
本轮入口验收已把必要材料复制到全新临时目录，从另一个工作目录实际运行
三组 analysis-only：全部通过，比较字段无差异。完整 --recompute 的命令
与冻结哈希检查通过；该入口没有为验收而再次重复整套控制仿真，组件的
完整运行与独立核查记录已随包保留。

三组结果的用途与位置
baselines/results/archived_conditional：旧预测和旧承诺的条件性对照；
  其原预测信息可用时间仍未完全恢复，不得称作已经证实的历史因果预测。
baselines/results/causal_development：新时间链下的 2021 英国开发实验；
  2021 数据此前已经使用，不是盲测。
baselines/results/confirmation：历史内部目录名，指最终论文中的澳大利亚 external stress test；为保留冻结结构与哈希不重命名。各方法文件为
  confirmation_aemo_20260911_28.npz。
前两组各方法文件为 development_2021.npz。
analysis/<同名组>/summary.json 给出主结果、严重度和资源摘要；
paired_rates.csv、resource_summary.csv、target_matched_risk_scores.csv
及 bootstrap.json 给出完整表和不确定性记录。

固定模型与源数据
inputs/calibration_2021.npz 的 SHA256：
f7ac536781eff817b5387d52b8e5d045f7ac2fe4c325290dc3cdf2ca6b74f4b4
causal_inputs/frozen_model.npz 的 SHA256：
dc3d2569c73df9d87356a106cd9d0bbcc52985ac7a0185b9b47ccd2498c4f374
拟合截止 2021-09-09 16:00 UTC；残差库截止 2021-10-07 16:00 UTC。
3995 个训练起点；4020 条冻结残差路径（每个小时内相位 670 条）。
只使用滞后 2..25 的 24 个功率值与 UTC 日周期正余弦，ridge alpha=10。
观测可用时间明确假设为标签时间加 20 分钟。
新合成承诺在交付小时 h 前 60 分钟发行，采用 h 前 80 分钟的观测值。
预测和承诺的发行时间由代码构造，不是恢复出的真实市场发布日志。

外部确认数据与来源限定
COOPGWF1（Coopers Gap）确认期为 AEST 固定 UTC+10：
2026-09-11 00:00（含）至 2026-09-29 00:00（不含），共 18 日。
对应 UTC [2026-09-10T14:00:00Z, 2026-09-28T14:00:00Z)。
共 2592 个完整十分钟时段；每个方法在首个确认起点重置物理状态。
更早记录只提供历史特征和承诺来源，不运行或报告期外控制结果。
先前素材已包含 Sep01/08/09/10 日包，因此保守排除 Sep01..10。
未在已审查元数据和可读协议中找到本次较窄时段的先前使用，但不能
由此断言穷尽了所有历史，也不能声称这个澳大利亚站点从未在别处使用。

AEMO SCADA 是每五分钟的区间起点瞬时 MW，不是结算电量。
SETTLEMENTDATE 按官方调度数据模型的区间结束标签解释；减 5 分钟后
得到观测时刻。十分钟值是 t 与 t+5min 两个快照的均值，是零阶保持
近似下的功率/能量代理，不是现场实测十分钟平均功率。
453 MW 是 Tilt 和 AGL 项目铭牌归一化基准；AEMO 2025 ELI 的历史
maximum-capacity 栏列为 440 MW，两者不混称当前注册或出口上限。
不截断实测代理值、不插值、不用零补缺。文件头创建时间和 LASTCHANGED
保留作来源证据，不能替代实时公共发布或接收时间。
来源 URL、语义依据、容量差异、每个日包哈希分别保存在
confirmation/source_semantics_evidence.json 与 download_manifest.json。

原始日包的可选结构复现（不属于上述两种主入口）
为避免改动已冻结的 provenance 文件，在新目录复制整个 confirmation
文件夹后，从该副本运行下面命令。若 raw 内已有 30 个日包，无需网络：
  python acquire_scada_structure.py --reference-mw 453 --reference-description "Fixed project nameplate normalization reference; not current export capacity"
若自行重获缺失日包，可在同一命令加 --download；仅从 AEMO 官方 URL 下载。
原始包日期为 2026-08-30..2026-09-28，共 8640 个五分钟快照、4320 个
十分钟代理。主分析使用既存 COOPGWF1_10min_normalized.csv，列为
timestamp,power,episode；其 SHA256 为：
b09d94faa479735c0555c5520097a16d05a4558d95665a21c3ab3c3233b35c9f

控制比较与解释边界
三个控制器均执行固定电池/备用功率指令，采用同一物理资源、效率、
小时预算及预先承诺出口上限下的本地弃风规则。DMPC 是直接优化连续
功率指令的确定性线性规划；F_BR0 使用固定 225 动作菜单和 32 条残差路径。
主比较固定同一状态与第一步指令，比较“起点冻结预测驱动的 FULL 后续策略”
和实际滚动执行；DMPC 另报自己的原始优化指令序列。
滚动 F_FULL 可因未来预测修订与冻结后续策略不同，不能当作零差异负对照。
负对照是相同固定指令序列、状态、风功率、承诺和执行器的再次回放。
Brier 分数只对相同后续策略定义的标签计算，不能直接解释为滚动部署保证。
缺供频率必须连同缺供能量严重度和资源使用阅读，不作全指标优越或节约成本结论。
7 日配对块自助法为主，1/14 日为敏感性；18 日确认无法证明季节稳健性。
区间条件于冻结模型和固定 episode 混合，不涵盖训练、选题或站点抽样不确定性。

冻结与实施修复
protocol_round3.json 和 confirmation_freeze.json 保留评分前的设计与哈希。
causal_inputs/confirmation_amendment_01.json 记录一次 CSV 时间戳容器修复：
在生成任何确认预测或结果前，将 pandas Series 明确转换为 DatetimeIndex。
模型、参数、数据窗和科学方法均未改变。入口验证原冻结记录，并只应用
该显式 amendment 的代码哈希替换；不会暗中接受其他代码修改。
review/ 下保留物理约束、MPC、因果信息流和已保存结果的独立审查。
upstream/provenance/ 保留旧承诺生成规则的恢复证据；上游原预测源码
下载故障和缺失真实发布时间证据不因本次新合成流程而自动消失。

独立核验与历史记录
review/review_saved_mpc.py 可用 --input、--results、--output 指定对应数据和新输出目录。
review/review_causal_pipeline.py、review_confirmation_inputs.py、review_analysis_summary.py
均提供显式路径参数；先运行 --help 查看，勿覆盖归档审核结果。
upstream/provenance/reconstruct_archived_timing.py --output 新目录 可重算旧承诺算术核查。
previous_round2_* 为上一轮保留记录，其旧承诺未恢复状态被本轮 timing_reconstruction_summary.json 的
算术证据部分更新；真实发布时间与旧预测源码仍未恢复。
baselines/test_baselines.py 是早期与第二轮模拟器的交叉检查，需要另有第二轮代码；本包的
独立物理核验请用 review/review_mpc_implementation.py，其依赖已包含。
