《通信学报》可复现性与实验可重复

本技能帮助让《通信学报》(Journal on Communications, JOC) 稿件的实验可被复现。JOC 由中国通信 学会主办，虽无独立制品徽章制度（见 jonc-artifact-evaluation），但通信仿真结果的可复现性是外审 判断可信度的核心。以下与 2026-07-09 核验的本刊定位一致（见 resources/official-source-map.md）。

一、可复现性三层

二、必须固定的要素

三、复现包组织

参照 resources/code/README.md：

repo/
├── README.md      # 环境 + 一键复现主图命令
├── env/           # requirements.txt / environment.yml / 工具版本
├── src/           # 信道、方法、基线、指标
├── configs/       # 每图一 config，含种子
├── data/          # 数据或生成脚本 + 校验和
└── scripts/       # run_figX.* 与论文图号对应

四、防范数据泄漏与挑参

• 泄漏防范：测试信道/数据不得参与训练或调参；时序数据防未来信息泄漏。
• 挑参防范：报告参数选取依据；给敏感性分析，避免只报最优点。
• 信道复用陷阱：训练与评测用同一批信道实现会高估性能，须分离。

五、受限数据/私有测量

• 公开数据：给来源、版本、许可。
• 自建数据：给生成脚本与统计描述。
• 私有/受限测量：说明获取方式、脱敏处理与待核实的许可限制，尽量给可公开的替代验证。

六、写入正文

• 实验设置节：列信道模型、参数表、种子、仿真次数、平台版本。
• 数据可用性/致谢：说明代码与数据的开放程度与获取方式。
• 匿名评审阶段用匿名仓库链接（若适用）。

七、复现自查清单

• 随机种子、信道实现、蒙特卡洛次数已固定并报告。
• 每张主图有对应 config 与运行命令。
• 数据划分固定、无泄漏；训练/评测信道分离。
• 软件与库版本记录完整。
• 参数选取有依据、附敏感性分析。
• 受限数据的获取与许可已说明（待核实 项标注）。
• 正文实验设置与数据可用性声明齐备。

八、常见问题与修法

九、通信仿真的可复现性陷阱（专项）

通信仿真有一些区别于通用机器学习的复现陷阱，外审专家尤为敏感：

十、复现包 README 最小内容

# 环境
- OS / MATLAB(或 Python) 版本 / 关键库版本
# 一键复现
- bash scripts/run_fig3.sh   # 生成正文图 3（SNR-BER）
- bash scripts/run_fig5.sh   # 生成正文图 5（吞吐-负载）
# 参数
- configs/fig3.yaml（含 seed、SNR 范围、蒙特卡洛次数）
# 数据
- data/ 下载脚本 + 校验和（md5）
# 预计运行时间与硬件
- 图 3 约 ___ 分钟（CPU/GPU ___）

十一、与其它技能衔接

• 与 jonc-experiments 配套：实验设计定稿即固化复现要素。
• 与 jonc-supplementary 配套：把冗长参数表、额外场景放附录。
• 与 jonc-submission 配套：投稿时附复现包链接与数据可用性声明。
• 与 jonc-artifact-evaluation 配套：以复现包达到 L3 及以上可用性成熟度。

十二、要点回顾

• 可复现性分三层：可重复、可复现、可推广；通信实证至少做到可复现。
• 必须固定并报告：随机种子、信道实现、蒙特卡洛次数、参数表、数据划分、软件版本。
• 警惕通信专项陷阱：信道未固定、仿真次数不足、SNR 定义混用、训练评测信道复用。
• 复现包给 README + configs + scripts + 数据校验和，实现主图一键复现。
• 把复现信息写入实验设置节与数据可用性声明；受限数据说明获取方式（待核实 许可）。

目标：让《通信学报》/Journal on Communications (JOC) 的外审可以按 README 在声明环境下复现主图主表， 这是通信类实证长文可信度的底线，也是三审制下加分的稳妥做法。