| name | aes-reproducibility |
| description | 当你为《电子学报》(Acta Electronica Sinica, AES) 稿件强化可复现性与实验可重复时使用。覆盖电子/信息/信号处理/通信类工作的实验环境记录、随机性控制、数据与预处理透明、算法伪代码与超参数完整披露、硬件与仿真工具链版本、统计显著性与多次运行、以及在中文学报正文与附录里如何组织可复现信息。帮助作者用可复现性作为通过《电子学报》外审、抵御"结果无法重复"质疑的核心竞争力，而非事后补救。 |
《电子学报》可复现性与实验可重复
可复现性是《电子学报》(Acta Electronica Sinica, AES) 外审专家评判一篇电子信息类论文成色的隐形
主线。本刊由中国电子学会 (Chinese Institute of Electronics) 主办，审稿人多为领域内一线学者，
最常见的退稿或退修理由之一就是"实验条件交代不清、结果难以重复"。本技能教你把可复现性前置
到写作与实验设计阶段，而不是等审稿人质疑后再补。以下建议对齐通行的中文科技期刊规范；本刊未
单独公布可复现性细则者标 待核实，以《投稿须知》为准（核验日 2026-07-09，官网 ejournal.org.cn）。
一句话：可复现性 = 让任何一个同行按你写的条件，能得到与你统计意义上一致的结果。
这是 Acta / Electronica / Sinica 学报里区分"可信工作"与"疑似过拟合"的分水岭。
一、可复现信息的四大支柱
| 支柱 | 必须交代 |
|---|
| 环境 | 操作系统、语言/框架版本、关键库版本、硬件(CPU/GPU/FPGA/仪器) |
| 数据 | 来源、规模、划分、预处理、是否公开、获取方式 |
| 方法 | 完整算法/伪代码、全部超参数、初始化、停止准则 |
| 评测 | 指标定义、运行次数、随机种子、统计处理 |
二、环境与工具链记录
- 明确记录仿真/开发工具及版本：MATLAB/Simulink、Python(含关键库)、ADS、HFSS/CST、Vivado/Quartus 等。
- 硬件实验记录器件型号、测量仪器型号与关键设置（采样率、带宽、触发方式）。
- 尽量提供
requirements.txt / environment.yml / Dockerfile（配合 aes-artifact-evaluation）。
三、随机性控制
- 固定并报告随机种子；对含随机初始化的算法，明确种子对结果的影响。
- 结果不应依赖某一"幸运种子"：对随机方法多次独立运行（如 ≥5 次），报告均值 ± 标准差。
- 数据划分（训练/验证/测试）方式固定并说明；避免测试集信息泄露到训练/调参。
四、数据透明
- 公开数据集给出名称、版本与出处；自采数据说明采集设备、条件、规模、标注协议。
- 预处理每一步（滤波、归一化、去噪、增强、重采样）都要可被复述，给出参数。
- 说明数据获取与使用的授权/伦理合规；敏感或涉密数据按脱敏要求处理。
五、方法可复现
- 给出完整伪代码，关键步骤不省略；符号与正文一致。
- 列出全部超参数（学习率、批大小、层数、正则、迭代次数、阈值等），最好用一张超参数表。
- 说明初始化方式、优化器、停止准则；对比方法的超参数也应说明来源（原文默认或重新调优）。
六、评测与统计
- 指标定义清晰（如 SNR、BER、误差率、准确率、运行时间、资源占用），与领域惯例一致。
- 关键结论辅以统计检验或多次运行的波动区间，而非单次最好结果。
- 消融实验隔离每个组件的贡献，支撑"是这个设计而非偶然"的论断（见
aes-experiments）。
七、正文与附录的组织
- 正文实验小节交代核心可复现信息；冗长的完整超参数表、额外运行结果放附录/补充材料（见
aes-supplementary）。
- 用一句话指明制品/数据托管位置，方便审稿人核验。
- 图表标注运行次数与误差条，避免只给一条曲线却宣称普适。
八、可复现性自检清单
九、可复现性成熟度分级
用一个简单的分级自评，判断稿件当前处于什么水平，并明确下一步：
| 级别 | 特征 | 对录用的影响 |
|---|
| L0 | 只给文字描述，无环境/种子/超参数 | 高风险，易被质疑难重复 |
| L1 | 完整超参数表 + 环境版本 | 基本可信 |
| L2 | L1 + 多次运行 + 统计报告 | 说服力强 |
| L3 | L2 + 公开可运行制品(代码/数据) | 最强，利于长期引用 |
投《电子学报》建议至少做到 L2，条件允许做到 L3（配合 aes-artifact-evaluation）。
十、可复现性与诚信的关系
- 可复现不是负担，而是科研诚信的技术体现：让别人能验证，才配称可靠结论。
- 如实报告失败工况、对种子的敏感性、与理论的偏差，比只展示最优结果更能取信于本刊审稿人。
- 一旦发表后被发现不可复现，代价远高于投稿时多花的记录成本——把功夫下在前面。
十一、常见不可复现陷阱
- 训练/调参时无意用到测试集信息（数据泄露）。
- 只保存"最好那次"的结果与图，未记录多次运行分布。
- 依赖某台机器的特定环境，未锁定库版本导致他人跑不通。
- 预处理步骤散落在多个脚本、无法按序复述。
逐一排除这些陷阱，是稿件在《电子学报》(Acta Electronica Sinica, AES) 经得起复现追问的底线保障。
十二、可复现性写作小结
- 在实验设置处集中交代环境、数据划分、随机种子与关键超参数。
- 完整超参数表、额外运行结果放附录，正文保持可读（配合
aes-supplementary）。
- 用一句话指明制品/数据托管位置，让审稿人可核验。
- 图上加误差条并标注运行次数，避免只给单条曲线却宣称普适结论。
输出格式（可复现性审计）
【《电子学报》(AES) 可复现性审计】
环境记录：<完整 / 缺 GPU 版本 …>
随机控制：<种子已报，N=5 次运行 / 单次结果 需补>
数据透明：<公开+划分说明 / 自采需补采集参数>
方法披露：<伪代码+超参数表 / 缺停止准则>
评测统计：<均值±方差+检验 / 仅单次最优 需补>
附录组织：<完整细节已入附录>
待核实：<本刊可复现性专门要求>
风险：<外审"难以重复"质疑概率：低/中/高>
把可复现性做扎实，是稿件在《电子学报》(Acta Electronica Sinica, AES) 外审中抵御"结果无法重复"
质疑、稳步走向录用的最可靠底盘。
