透明度與資料 (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/ installs) - 已設定並報告隨機種子(用於拔靴法與模擬)
- 稿件中的圖表編號完全匹配已存檔的輸出
- 限制資料:豁免註記 + 取得條件 + 抽取規格 + 可行時使用合成資料
- 提交作者已註冊ORCID;已聲明資金來源/利益衝突/倫理資訊
反模式
- 將資料聲明視為接受前最後一刻的例行公事
- 使用個人網址或通用雲端連結,而非 FAIR 倉儲中的持久識別碼
- 發布您無權重新散布的授權 DHS/普查微資料(應改為分享抽取程式碼)
- 缺乏文件、隨機種子、註解的程式碼,且「在我的機器上才能執行」
- 聲稱資料受限卻未說明取得條件
在 PDR 中,再現性審查者預期什麼
PDR 的審查者會重新推導分母或重新執行分解,並關心授權資料是否被正確處理。請根據您實際使用的資料類別調整套件。
| 資料類別 | 典型來源 | 儲存義務 |
|---|---|---|
| 完全公開 | HMD、HFD、WPP、已出版的動態統計、世界銀行/WDI | 抽取程式碼 + 建構的分析檔案(若授權允許) + 持久識別碼 |
| 公開但需授權 | IPUMS、DHS、重新散布受限的普查 | 抽取規格 + 程式碼,非原始微資料;引用提供者的持久取得路徑 |
| 限制/保密 | 連結行政紀錄、RDC 專屬普查、連結登錄資料 | 程式碼 + 合成替代檔案 + 確切的取得條件註記 |
審查者質疑模式與 PDR 專屬修正
- 「我無法分辨這些數字來自哪個 WPP/HMD 版本或哪輪 DHS。」 -> 在 README 和程式碼註解中記錄發布標籤與下載日期;版本與輪次會更改數值。
- 「您發布了 DHS 微資料——這違反了授權。」 -> 移除原始微資料;提供 DHS 抽取請求規格與清理程式碼,並將 DHS 引用為持久取得路徑。
- 「您的拔靴/預測區間無法再現。」 -> 為每個重抽樣與模擬步驟設定並報告隨機種子。
- 「您說資料受限,但未提供取得方式。」 -> 指明資料飛地或申請管道及取得條件;僅寫「受限」會讓人覺得是在迴避。
輸出格式
【資料聲明】公開 / 限制 / 經請求提供 — 已草擬並附持久識別碼?[Y/N]
【倉儲】FAIR 倉儲 + DOI/入藏號(非個人網址)?[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 資料取得與誠信政策