Données & Reproductibilité (demog-data-and-reproducibility)
Demography demande pour chaque manuscrit accepté une déclaration de disponibilité des données et encourage le code reproductible. La revue ne gère pas son propre dépôt — vous choisissez un dépôt conforme aux principes FAIR et fournissez des identifiants persistants. Construisez les éléments au fur et à mesure pour que l'acceptation ne soit pas bloquée.
Quand déclencher
- Construction des éléments de reproductibilité/réplication et de la déclaration de disponibilité des données
- Un manuscrit a été accepté et vous devez finaliser la déclaration et effectuer le dépôt
- Les données ne peuvent pas être entièrement partagées (vie privée, confidentialité, restrictions propriétaires/fournisseur) et vous avez besoin du langage d'exemption
- Choix d'un dépôt et d'un identifiant persistant
Ce que Demography exige (vérifiez la formulation en vigueur sur la page d'éthique/déclarations)
- Déclaration de disponibilité des données. Les manuscrits acceptés doivent inclure une déclaration confirmant si et comment les données ont été partagées. Pour les données publiquement disponibles, décrivez la méthode d'accès avec un identifiant persistant (DOI ou numéro d'accession).
- Identifiants persistants + dépôt FAIR. Comme Demography n'héberge pas de dépôt, déposez les données et les éléments dans un dépôt conforme aux principes FAIR (par ex., ICPSR/openICPSR, Harvard Dataverse, Zenodo, OSF) et citez-le avec un lien permanent — pas un site web personnel ou un dossier cloud générique. Trouvez-en un via FAIRsharing.org ou re3data.org.
- Code reproductible (encouragé). Fournissez un code qui régénère les résultats, avec les versions des logiciels enregistrées et des commentaires informatifs expliquant chaque étape. Considérez cela comme attendu, pas facultatif, pour un article quantitatif en démographie.
- Données restreintes. Lorsque l'accès est limité pour protéger des informations confidentielles ou propriétaires, décrivez les conditions limitant l'accès et comment d'autres peuvent obtenir les données, tout en restant aligné avec les principes FAIR autant que possible.
Liste de vérification « construire au fur et à mesure »
- Déclaration de disponibilité des données rédigée (publique / restreinte / sur demande) avec des identifiants persistants
- Données + éléments déposés dans un dépôt FAIR avec un DOI/numéro d'accession
- Un script maître régénère chaque tableau, figure, table de mortalité et décomposition
- Le README documente la provenance/vintage des données, la construction des taux/exposition, et comment reproduire chaque élément
- Code commenté et versions des logiciels/packages enregistrées (
renv.lock/requirements.txt/ installs) - Graines définies et rapportées pour bootstrap, simulation, microsimulation
- Les numéros d'éléments dans le manuscrit correspondent exactement aux fichiers déposés
- Données restreintes : note d'exemption + conditions d'accès + données synthétiques si faisable
Anti-patrons
- Traiter la déclaration de données comme une formalité de dernière minute à l'acceptation
- Une URL personnelle ou un lien cloud générique au lieu d'un identifiant persistant dans un dépôt FAIR
- Code non documenté, non semé, non commenté qui « marche sur ma machine »
- Prétendre que les données sont restreintes sans décrire les conditions d'accès
- Appeler les frais de gestion éditoriale de 1 000 $ un « accès ouvert » ou « frais de données » (ce n'est ni l'un ni l'autre)
Ce qu'un relecteur de reproductibilité attend chez Demography
Demography, le vaisseau amiral de la Population Association of America publié en libre accès par Duke University Press, attire des relecteurs qui recalculent régulièrement un dénominateur ou refont à la main une décomposition de Kitagawa. Le dépôt doit leur permettre de le faire. Calibrez le package en fonction de la classe de données que vous avez réellement utilisée.
| Classe de données | Source typique | Obligation de dépôt |
|---|---|---|
| Entièrement publiques | HMD, HFD, IPUMS, WPP, statistiques de l'état civil publiées | Code d'extraction + fichier analytique construit (si la licence le permet) + identifiant persistant |
| Publiques mais sous licence | IPUMS, DHS, recensement avec restrictions de redistribution | Spécification d'extraction + code, pas les microdonnées brutes ; citez le chemin d'accès persistant du fournisseur |
| Restreintes/confidentielles | Dossiers administratifs liés, recensement RDC uniquement, fichiers de mortalité liés | Code + fichier de substitution synthétique + note exacte sur les conditions d'accès |
Schémas de contestation des relecteurs et la correction spécifique à Demography
- « Je ne peux pas dire quelle version HMD/HFD a produit ces taux. » -> Enregistrez le label de version et la date de téléchargement dans le README et un commentaire de code ; les versions révisent les taux historiques.
- « Les composantes de décomposition dans le dépôt ne correspondent pas au nombre principal. » -> Ajoutez une assertion que les composantes se concilient avec le changement total de e0 (ou TFR) avant de déposer ; expédiez la vérification réussie.
- « Vos intervalles bootstrap ne sont pas reproductibles. » -> Définissez et rapportez une graine pour chaque rééchantillonnage, microsimulation et étape de graduation ; un intervalle non semé est considéré comme non reproductible.
- « Vous dites que les données sont restreintes mais ne donnez aucun moyen de les obtenir. » -> Nommez l'enclave de données ou le chemin de candidature et les conditions d'accès ; un simple « restreint » est perçu comme une esquive.
Format de sortie
【Déclaration de données】publique / restreinte / sur demande — rédigée avec un identifiant persistant ? [O/N]
【Dépôt】Dépôt FAIR + DOI/numéro d'accession (pas une URL personnelle) ? [O/N]
【Code reproductible】script maître + commentaires + versions enregistrées + graines ? [O/N]
【Éléments correspondent au dépôt ?】[O/N]
【Données restreintes ?】conditions d'accès décrites + données synthétiques si faisable ?
【Suite】demog-review-process
Ressources supplémentaires
../../resources/external_tools.md— Dépôts FAIR et outils de reproductibilité../../resources/official-source-map.md— Politique de Demography sur la disponibilité des données et le code reproductible