透明与数据(popdevr-transparency-and-data)
PDR 隶属于 Wiley 的作者与研究诚信框架:需要提供数据可用性声明,鼓励/要求提交作者使用 ORCID,且作者应在伦理和许可允许的前提下提供数据与材料。PDR 自身不托管仓库——您需选择一个 FAIR 仓库并提供持久标识符。请在研究过程中逐步构建材料,以免修改和接收阶段出现延误。请核实 Wiley 作者页面和数据政策页面上的最新措辞。(待核实)
何时触发
- 构建可复现性材料与数据可用性声明
- 稿件进入修改/接收阶段,需要最终确定声明并存入仓库
- 数据无法完全共享(隐私、保密性、DHS/人口普查许可、提供方限制),需要豁免措辞
- 选择仓库和持久标识符;设置 ORCID
PDR / Wiley 的要求(请核实作者页面上的最新政策)
- 数据可用性声明。 提供一份声明,描述是否以及如何获取支撑结果的数据。对于公共数据,给出包含持久标识符(DOI 或登录号)的访问方式;对于受限数据,说明访问条件。
- FAIR 仓库 + 持久标识符。 由于 PDR 自身不托管仓库,请将数据和材料存入符合 FAIR 原则的仓库(ICPSR/openICPSR、Harvard Dataverse、Zenodo、OSF),并附上永久链接——不要使用个人网站或通用云文件夹。可通过 FAIRsharing.org 或 re3data.org 查找仓库。
- 可复现、有文档的代码。 提供能重新生成结果的代码,并记录软件版本和添加信息性注释。对于定量人口与发展论文,这应视为预期要求,而非可选项。
- 受限数据(该领域常见)。 DHS、人口普查微观数据和关联管理记录通常受许可或保密限制——描述限制访问的条件以及他人如何获取数据,提供提取说明和代码而非原始微观数据,并尽可能遵循 FAIR 原则。
- ORCID 与诚信。 为提交作者提供 ORCID;声明资金、利益冲突以及涉及人类被试时的伦理/知情同意。
构建时可用的检查清单
- 起草数据可用性声明(公共/受限/按需提供),附上持久标识符
- 将数据+材料存入 FAIR 仓库,提供 DOI/登录号
- 一个主脚本重新生成所有表格、图形、生命表、分解和预测
- README 文档记录数据来源/版本、比率/暴露的构建方式以及如何复现每个图表
- 代码添加注释并记录软件/包版本(
renv.lock/requirements.txt/ 安装说明) - 设置并报告 bootstrap 和模拟的随机种子
- 手稿中的图表编号与存入的输出完全一致
- 受限数据:豁免说明 + 访问条件 + 提取说明 + 可能情况下的合成数据
- ORCID 已为提交作者注册;资金/利益冲突/伦理已声明
反模式
- 把数据声明当成接收时的最后一刻形式
- 使用个人 URL 或通用云链接,而非 FAIR 仓库中的持久标识符
- 发布未经许可的 DHS/人口普查微观数据(应分享提取代码)
- 无文档、无种子、无注释的“在我的机器上能跑”的代码
- 声称数据受限却不说明访问条件
PDR 的可复现性审稿人期望
PDR 的审稿人会重新推导分母或重新运行分解,并关心许可数据是否被正确处理。请根据实际使用的数据类别调整包内容。
| 数据类别 | 典型来源 | 存放义务 |
|---|---|---|
| 完全公开 | HMD, HFD, WPP, 已发布的生命统计数据, World Bank/WDI | 提取代码 + 构建的分析文件(若许可允许) + 持久标识符 |
| 公开但需许可 | IPUMS, DHS, 限制再分发的人口普查 | 提取说明 + 代码,非原始微观数据;引用提供方的持久访问路径 |
| 受限/机密 | 关联管理记录, RDC 专属人口普查, 关联注册数据 | 代码 + 合成替身文件 + 确切的访问条件说明 |
审稿人反驳模式与 PDR 特定修复
- “我无法判断这些数据来自哪个 WPP/HMD 版本或 DHS 轮次。” -> 在 README 和代码注释中记录版本标签和下载日期;版本和轮次会影响数据。
- “你发布了 DHS 微观数据——这违反了许可。” -> 移除原始微观数据;提供 DHS 提取请求说明和清洗代码,并引用 DHS 作为持久访问路径。
- “你的 bootstrap/预测区间无法复现。” -> 为每个重采样和模拟步骤设置并报告随机种子。
- “你说数据受限,但没有提供获取方法。” -> 注明数据托管或申请途径及访问条件;仅说“受限”会被视为回避。
输出格式
【数据声明】公共 / 受限 / 按需提供 — 已起草并附持久标识符?[Y/N]
【仓库】FAIR 仓库 + DOI/登录号(非个人 URL)?[Y/N]
【许可数据处理】DHS/人口普查使用提取代码而非原始微观数据?[Y/N/NA]
【可复现代码】主脚本 + 注释 + 记录版本 + 种子?[Y/N]
【图表与存放匹配?】[Y/N]
【ORCID + 声明】提交作者 ORCID + 资金/利益冲突/伦理?[Y/N]
【下一步】popdevr-review-process
补充资源
../../resources/external_tools.md— FAIR 仓库与可复现性工具../../resources/official-source-map.md— PDR / Wiley 数据可用性与诚信政策