透明性とデータ (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を提供し、資金提供、利害関係、および人間被験者が関与する場合は倫理/同意を宣言します。
進行中チェックリスト
- データ提供表明 を作成(公開 / 制限付き / リクエストに応じて)し、永続IDを付与
- データ + 資料を FAIRリポジトリ に預託し、DOI/アクセッション番号を取得
- すべての表、図、生命表、分解、予測を再生成する マスタースクリプト が1つある
- README にデータの出典/ヴィンテージ、率/曝露の構築方法、各展示を再現する方法を文書化
- コードにコメント を付け、ソフトウェア/パッケージバージョンを記録(
renv.lock/requirements.txt/ インストール手順) - ブートストラップとシミュレーションのための シード を設定し報告
- 原稿内の展示番号が、預託された出力と 正確に一致 している
- 制限付きデータ:例外注釈 + アクセス条件 + 抽出仕様 + 可能であれば合成データ
- 提出者に ORCID を登録し、資金/利害/倫理を宣言
アンチパターン
- データ提供表明を受理時の直前の形式的なものとして扱う
- 個人のURLや汎用クラウドリンクを、FAIRリポジトリの永続識別子の代わりに使用する
- 再配布が許可されていないライセンス付きDHS/国勢調査ミクロデータを投稿する(代わりに抽出コードを共有する)
- 文書化されておらず、シードが設定されておらず、コメントのない「自分のマシンでは動く」コード
- アクセス条件を説明せずにデータが制限されていると主張する
PDRの再現性レビューアが期待すること
PDRは、分母を再導出したり分解を再実行したり、ライセンス付きデータが正しく処理されたことを確認する査読者を採用します。実際に使用したデータクラスに合わせてパッケージを調整してください。
| データクラス | 典型的な出典 | 預託義務 |
|---|---|---|
| 完全公開 | HMD, HFD, WPP, 公開された人口動態統計、World Bank/WDI | 抽出コード + 構築された分析ファイル(ライセンスが許す場合) + 永続ID |
| 公開だがライセンス付き | IPUMS, DHS, 再配布制限付き国勢調査 | 抽出仕様 + コード、生のミクロデータ ではない。プロバイダの永続アクセスパスを引用 |
| 制限付き/機密 | 連結行政記録、RDC限定国勢調査、連結レジスター | コード + 合成代替ファイル + 正確なアクセス条件の注釈 |
査読者からの反発パターンとPDR固有の修正方法
- 「どのWPP/HMDヴィンテージやDHSラウンドがこれらの数値を生成したのかわからない。」 -> リリースラベルとダウンロード日をREADMEとコードコメントに記録。ヴィンテージとラウンドは数値を修正する。
- 「DHSミクロデータを投稿した — ライセンス違反です。」 -> 生のミクロデータを削除。DHS抽出リクエスト仕様とクリーニングコードを提供し、DHSを永続アクセスパスとして引用。
- 「ブートストラップ/予測区間が再現できません。」 -> すべてのリサンプリングとシミュレーションステップにシードを設定し報告。
- 「データは制限されていると言うが、入手方法を何も示していない。」 -> データエンクレーブや申請経路、アクセス条件を名指しする。「制限あり」とだけ書くと回避とみなされる。
出力フォーマット
【データ提供表明】公開 / 制限付き / リクエストに応じて — 永続ID付きで作成済み? [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のデータ提供表明と整合性ポリシー