Daten & Reproduzierbarkeit (demog-data-and-reproducibility)
Demography verlangt von jedem angenommenen Manuskript eine Datenverfügbarkeitserklärung und fördert reproduzierbaren Code. Die Zeitschrift betreibt kein eigenes Repositorium – Sie wählen ein FAIR-Repositorium und geben persistente Identifikatoren an. Bauen Sie die Materialien auf, während Sie fortschreiten, damit die Annahme nicht ins Stocken gerät.
Wann auslösen
- Erstellung der Reproduzierbarkeits-/Replikationsmaterialien und der Datenverfügbarkeitserklärung
- Ein Manuskript wurde zur Annahme angenommen und Sie müssen die Erklärung finalisieren und hinterlegen
- Daten können nicht vollständig geteilt werden (Datenschutz, Vertraulichkeit, proprietäre/Anbieterbeschränkungen) und Sie benötigen die Ausnahmesprache
- Auswahl eines Repositoriums und einer persistenten Kennung
Was Demography verlangt (aktuelle Formulierung auf der Ethik-/Offenlegungsseite prüfen)
- Datenverfügbarkeitserklärung. Angenommene Manuskripte müssen eine Erklärung enthalten, die bestätigt, ob und wie die Daten geteilt wurden. Beschreiben Sie bei öffentlich zugänglichen Daten die Zugriffsmethode mit einer persistenten Kennung (DOI oder Akzessionsnummer).
- Persistente Identifikatoren + FAIR-Repositorium. Da Demography kein Repositorium hostet, hinterlegen Sie Daten und Materialien in einem FAIR-konformen Repositorium (z. B. ICPSR/openICPSR, Harvard Dataverse, Zenodo, OSF) und zitieren Sie es mit einem dauerhaften Link – nicht mit einer persönlichen Website oder einem generischen Cloud-Ordner. Finden Sie eines über FAIRsharing.org oder re3data.org.
- Reproduzierbarer Code (empfohlen). Stellen Sie Code bereit, der die Ergebnisse neu generiert, mit aufgezeichneten Softwareversionen und informativen Kommentaren, die jeden Schritt erklären. Behandeln Sie dies für eine quantitative demografische Arbeit als erwartet, nicht als optional.
- Eingeschränkte Daten. Wenn der Zugang zum Schutz vertraulicher oder proprietärer Informationen eingeschränkt ist, beschreiben Sie die Bedingungen, die den Zugang einschränken, und wie andere die Daten erhalten können, während Sie sich dennoch so weit wie möglich an die FAIR-Prinzipien halten.
Checkliste für den Aufbau während der Erstellung
- Datenverfügbarkeitserklärung entworfen (öffentlich / eingeschränkt / auf Anfrage) mit persistenten IDs
- Daten + Materialien in einem FAIR-Repositorium mit einer DOI/Akzessionsnummer hinterlegt
- Ein Hauptskript generiert alle Tabellen, Abbildungen, Sterbetafeln und Zerlegungen neu
- README dokumentiert die Datenherkunft/Version, Konstruktion von Raten/Exposition und wie jedes Element reproduziert wird
- Code kommentiert und Software-/Paketversionen aufgezeichnet (
renv.lock/requirements.txt/ installs) - Seeds gesetzt und gemeldet für Bootstrap, Simulation, Mikrosimulation
- Abbildungsnummern im Manuskript stimmen exakt mit den hinterlegten Ausgaben überein
- Eingeschränkte Daten: Ausnahmehinweis + Zugangsbedingungen + synthetische Daten, wo machbar
Anti-Patterns
- Die Datenverfügbarkeitserklärung als letzte Minute-Formsache bei der Annahme behandeln
- Eine persönliche URL oder ein generischer Cloud-Link anstelle einer persistenten Kennung in einem FAIR-Repositorium
- Undokumentierter, ungesäter, unkommentierter Code, der „auf meinem Rechner läuft“
- Behaupten, Daten seien eingeschränkt, ohne die Zugangsbedingungen zu beschreiben
- Die 1.000-Dollar-Redaktionsgebühr als „Open-Access“- oder „Daten“-Gebühr bezeichnen (das ist sie nicht)
Was ein Reproduzierbarkeitsgutachter bei Demography erwartet
Demography, die Flaggschiff-Zeitschrift der Population Association of America, die bei Duke University Press im Open Access erscheint, zieht Gutachter an, die routinemäßig einen Nenner neu ableiten oder eine Kitagawa-Zerlegung von Hand durchführen. Die Hinterlegung muss ihnen dies ermöglichen. Kalibrieren Sie das Paket auf die tatsächlich verwendete Datenklasse.
| Datenklasse | Typische Quelle | Hinterlegungspflicht |
|---|---|---|
| Vollständig öffentlich | HMD, HFD, IPUMS, WPP, veröffentlichte Vitalstatistiken | Extraktionscode + konstruierte Analysedatei (wo Lizenz erlaubt) + persistente ID |
| Öffentlich, aber lizenziert | IPUMS, DHS, umverteilungsbeschränkter Zensus | Extraktionsspezifikation + Code, nicht die Roh-Mikrodaten; zitieren Sie den persistenten Zugangspfad des Anbieters |
| Eingeschränkt/vertraulich | Verknüpfte Verwaltungsdaten, RDC-only-Zensus, verknüpfte Sterblichkeitsdateien | Code + synthetische Ersatzdatei + genaue Zugangsbedingungen-Hinweis |
Gutachter-Rückweisungsmuster und die Demography-spezifische Lösung
- „Ich kann nicht erkennen, welche HMD/HFD-Version diese Raten hervorgebracht hat.“ -> Notieren Sie das Release-Label und das Download-Datum im README und in einem Code-Kommentar; Versionen überarbeiten historische Raten.
- „Die Zerlegungskomponenten in der Hinterlegung stimmen nicht mit der Überschriftzahl überein.“ -> Fügen Sie eine Behauptung hinzu, dass die Komponenten mit der Gesamt-e0 (oder TFR) -Änderung übereinstimmen, bevor Sie hinterlegen; liefern Sie den Check, der besteht.
- „Ihre Bootstrap-Intervalle sind nicht reproduzierbar.“ -> Setzen und melden Sie einen Seed für jeden Resampling-, Mikrosimulations- und Graduierungsschritt; ein ungesäteres Intervall gilt als nicht reproduzierbar.
- „Sie sagen, die Daten seien eingeschränkt, geben aber keine Möglichkeit, sie zu erhalten.“ -> Nennen Sie die Datensenke oder den Antragsweg und die Zugangsbedingungen; ein bloßes „eingeschränkt“ gilt als Ausweichmanöver.
Ausgabeformat
【Datenverfügbarkeitserklärung】öffentlich / eingeschränkt / auf Anfrage — mit persistenter ID erstellt? [J/N]
【Repositorium】FAIR-Repositorium + DOI/Akzessionsnummer (keine persönliche URL)? [J/N]
【Reproduzierbarer Code】Hauptskript + Kommentare + aufgezeichnete Versionen + Seeds? [J/N]
【Abbildungen stimmen mit Hinterlegung überein?】[J/N]
【Eingeschränkte Daten?】Zugangsbedingungen beschrieben + synthetische Daten wo machbar?
【Nächster Schritt】demog-review-process
Zusätzliche Ressourcen
../../resources/external_tools.md— FAIR-Repositorien und Reproduzierbarkeitswerkzeuge../../resources/official-source-map.md— Demography-Richtlinie zu Datenverfügbarkeit und reproduzierbarem Code