透明度與複製資料 (jpam-transparency-and-data)
JPAM 發表影響實際支出決策的計畫評估,因此證據必須可重現。期刊期望作者將報告結果背後的資料與程式碼存檔於合適的公開儲存庫,並附上清晰的資料可用性聲明。請在研究過程中逐步建立套件,以免耽誤接受程序——並及早為政策工作常見的限制使用行政資料做好規劃。上傳前,請先在 Wiley Authors / Research Exchange 中確認最新文字說明(检索于 2026-06-20;以官网为准)。
何時觸發
- 建置複製套件(資料 + 程式碼 + 說明文件)
- 稿件即將被接受,且要求提交材料時
- 資料為限制使用(行政、IRB 保護、提供者授權),需要豁免路徑時
- 撰寫資料可用性聲明時
需要準備的項目
- 公開存放。 將複製材料存放於經認可的儲存庫(例如計畫的 ICPSR/openICPSR 檔案庫、Harvard Dataverse、OSF,或期刊指定的儲存庫),並附上永久識別碼——不要使用個人網站或暫時的雲端連結。近期的 JPAM 資料可用性聲明常使用 JPAM/Harvard Dataverse 儲存庫,而 Research Exchange 則控制確切的儲存庫提示。
- 重現每個報告的數字。 一個主腳本從原始/建置資料重新產生所有表格與圖形。稿件中的圖表編號必須與套件輸出完全一致。
- 說明文件。 一份 README,涵蓋資料來源、建置步驟、軟體/套件版本、隨機步驟的種子,以及重現每個圖表的確切指令。
- 資料可用性聲明。 說明共享了什麼、存放於何處、採用哪種授權;若資料為限制使用,則精確說明原因以及複製者如何取得存取權。
限制使用行政資料(政策研究案例)
政策評估常使用無法公開的連結行政或調查微資料。JPAM 的透明度期望可誠實地透過以下方式達成:
- 解釋限制原因(法律、IRB、資料提供者授權)於資料可用性聲明中。
- 提供存取指示——申請流程、提供者聯絡方式與大約時程,以便獨立複製者能取得相同資料。
- 公開所有程式碼,加上任何可共享的衍生/彙整檔案,並在可行時提供合成或模擬資料,讓程式碼能完整端到端執行。
逐步建置檢查清單
- 一個主腳本重新產生每個表格與圖形
- README:資料來源、建置步驟、版本、種子、每個圖表的重現步驟
- 軟體/套件版本固定(
renv.lock/requirements.txt/ 已記錄安裝) - 稿件圖表編號與套件輸出完全一致
- 選擇具有永久識別碼的公開儲存庫(若期刊指定則使用指定者)
- 資料可用性聲明已草擬
- 限制使用資料:解釋限制原因 + 存取路徑 + 可行時提供合成資料
反模式
- 將套件視為接受後才處理的瑣事(這可能阻礙發表)
- 提交的程式碼實際上無法重現印刷的表格/圖形
- 使用個人 URL 或會過期的雲端連結,而非永久儲存庫
- 宣稱資料為限制使用,卻未提供存取路徑或合成替代品
- 無說明、未設定種子、未固定版本的程式碼,僅「在我的機器上能跑」
校準錨點(保留彈性)
- 政策評估高度依賴限制使用行政資料;誠實的限制說明加上實際的存取路徑,以及在合成/衍生資料上可執行的程式碼,是預期且可接受的路徑——這不是規避透明度的漏洞。
- 確切的存放要求、儲存庫提示與重現檢查工作流程可能改變;請在 Wiley Authors / Research Exchange 中確認當前資料政策的文字說明。
- 與分析過程同時建置套件:在接受後才改造以達重現性,正是政策論文卡關之處。
工作微範例(說明用)
一項福利改革評估使用了無法公開的連結州 UI 和 TANF 記錄。該套件仍滿足要求:資料可用性聲明說明了授權限制,並列出州政府資料請求流程與時程;所有程式碼連同主腳本一起存放;合成資料集比照變數結構,讓複製者能執行完整流程;另外也包含可共享的彙整表格。獨立研究人員能取得真實資料並重現每個數字。(說明用。)
輸出格式
【儲存庫】公開檔案庫 + 永久 ID —— 已選擇?[Y/N]
【可重現結果?】主腳本已在本機驗證?[Y/N]
【說明文件】README + 資料來源 + 種子 + 固定版本?[Y/N]
【限制使用資料?】已解釋限制原因 + 存取路徑 + 提供合成資料?
【資料可用性聲明】已草擬?[Y/N]
【下一步】jpam-review-process
補充資源
../../resources/official-source-map.md— JPAM 資料/複製政策證明與儲存庫準則../../resources/external_tools.md— 適用於限制資料專案的儲存庫與重現性工具