Data & Reproducibility (demog-data-and-reproducibility)
Demography asks every accepted manuscript for a data availability statement and encourages
reproducible code. The journal does not maintain its own repository — you choose a FAIR
repository and provide persistent identifiers. Build the materials as you go so acceptance does not
stall.
When to trigger
- Building the reproducibility/replication materials and the data availability statement
- A manuscript reached acceptance and you must finalize the statement and deposit
- Data cannot be fully shared (privacy, confidentiality, proprietary/provider restrictions) and you
need the exemption language
- Choosing a repository and persistent identifier
What Demography requires (verify current wording on the ethics/disclosures page)
- Data availability statement. Accepted manuscripts must include a statement confirming whether
and how the data have been shared. For publicly available data, describe the access method with
a persistent identifier (DOI or accession number).
- Persistent identifiers + FAIR repository. Because Demography hosts no repository, deposit data
and materials in a FAIR-aligned repository (e.g., ICPSR/openICPSR, Harvard Dataverse, Zenodo,
OSF) and cite it with a permanent link — not a personal website or generic cloud folder. Find one
via FAIRsharing.org or re3data.org.
- Reproducible code (encouraged). Provide code that regenerates the results, with software
versions recorded and informative comments explaining each step. Treat this as expected, not
optional, for a quantitative demographic paper.
- Restricted data. Where access is limited to protect confidential or proprietary information,
describe the conditions limiting access and how others may obtain the data, while still aligning
with FAIR principles as far as possible.
Build-as-you-go checklist
Anti-patterns
- Treating the data statement as a last-minute formality at acceptance
- A personal URL or generic cloud link instead of a persistent identifier in a FAIR repository
- Undocumented, un-seeded, uncommented code that "works on my machine"
- Claiming data are restricted without describing the access conditions
- Calling the $1,000 editorial-management fee an "open-access" or "data" charge (it is neither)
What a reproducibility reviewer expects at Demography
Demography, the Population Association of America flagship published open access by Duke University
Press, draws referees who routinely re-derive a denominator or re-run a Kitagawa split by hand. The
deposit must let them do so. Calibrate the package against the data class you actually used.
| Data class |
Typical source |
Deposit obligation |
| Fully public |
HMD, HFD, IPUMS, WPP, published vital statistics |
Extract code + constructed analytic file (where license permits) + persistent ID |
| Public-but-licensed |
IPUMS, DHS, redistribution-restricted census |
Extract specification + code, not raw microdata; cite the provider's persistent access path |
| Restricted/confidential |
Linked administrative records, RDC-only census, linked mortality files |
Code + synthetic stand-in file + exact access-conditions note |
Referee-pushback patterns and the Demography-specific fix
- "I cannot tell which HMD/HFD vintage produced these rates." -> Record the release label and download
date in the README and a code comment; vintages revise historical rates.
- "The decomposition components in the deposit do not sum to the headline number." -> Add an assertion
that components reconcile to the total e0 (or TFR) change before you deposit; ship the check passing.
- "Your bootstrap intervals are not reproducible." -> Set and report a seed for every resampling,
microsimulation, and graduation step; an un-seeded interval reads as un-reproducible.
- "You say data are restricted but give no way to obtain them." -> Name the data enclave or
application pathway and the access conditions; a bare "restricted" reads as evasion.
Output format
【Data statement】public / restricted / on request — drafted with persistent ID? [Y/N]
【Repository】FAIR repo + DOI/accession (not personal URL)? [Y/N]
【Reproducible code】master script + comments + recorded versions + seeds? [Y/N]
【Exhibits match deposit?】[Y/N]
【Restricted data?】access conditions described + synthetic data where feasible?
【Next】demog-review-process
Supplementary resources
1---2name: demog-data-and-reproducibility3description: Use when preparing the data-availability statement and reproducibility materials for a Demography (PAA / Duke University Press) manuscript. Demography requires a data availability statement at acceptance with persistent identifiers and encourages reproducible, commented code; it hosts no repository, so authors deposit in a FAIR repository. Covers restricted-data exemptions. Prepares the materials; it does not waive requirements.4metadata:5 source: https://skillmd.com/skills/brycewang-stanford/demog-data-and-reproducibility6---78# Data & Reproducibility (demog-data-and-reproducibility)910Demography asks every **accepted** manuscript for a **data availability statement** and **encourages11reproducible code**. The journal **does not maintain its own repository** — *you* choose a FAIR12repository and provide persistent identifiers. Build the materials as you go so acceptance does not13stall.1415## When to trigger1617- Building the reproducibility/replication materials and the data availability statement18- A manuscript reached acceptance and you must finalize the statement and deposit19- Data cannot be fully shared (privacy, confidentiality, proprietary/provider restrictions) and you20 need the exemption language21- Choosing a repository and persistent identifier2223## What Demography requires (verify current wording on the ethics/disclosures page)24251. **Data availability statement.** Accepted manuscripts must include a statement confirming **whether26 and how** the data have been shared. For publicly available data, describe the access method with27 a **persistent identifier** (DOI or accession number).282. **Persistent identifiers + FAIR repository.** Because Demography hosts no repository, deposit data29 and materials in a **FAIR-aligned repository** (e.g., ICPSR/openICPSR, Harvard Dataverse, Zenodo,30 OSF) and cite it with a permanent link — not a personal website or generic cloud folder. Find one31 via FAIRsharing.org or re3data.org.323. **Reproducible code (encouraged).** Provide code that regenerates the results, with **software33 versions recorded** and **informative comments** explaining each step. Treat this as expected, not34 optional, for a quantitative demographic paper.354. **Restricted data.** Where access is limited to protect confidential or proprietary information,36 **describe the conditions limiting access** and how others may obtain the data, while still aligning37 with FAIR principles as far as possible.3839## Build-as-you-go checklist4041- [ ] **Data availability statement** drafted (public / restricted / on request) with persistent IDs42- [ ] Data + materials deposited in a **FAIR repository** with a DOI/accession number43- [ ] One **master script** regenerates every table, figure, life table, and decomposition44- [ ] **README** documents data provenance/vintage, construction of rates/exposure, and how to reproduce each exhibit45- [ ] **Code commented** and **software/package versions recorded** (`renv.lock` / `requirements.txt` / installs)46- [ ] **Seeds** set and reported for bootstrap, simulation, microsimulation47- [ ] Exhibit numbers in the manuscript **match** the deposited output exactly48- [ ] Restricted data: exemption note + access conditions + synthetic data where feasible4950## Anti-patterns5152- Treating the data statement as a last-minute formality at acceptance53- A personal URL or generic cloud link instead of a persistent identifier in a FAIR repository54- Undocumented, un-seeded, uncommented code that "works on my machine"55- Claiming data are restricted without describing the access conditions56- Calling the $1,000 editorial-management fee an "open-access" or "data" charge (it is neither)5758## What a reproducibility reviewer expects at Demography5960Demography, the Population Association of America flagship published open access by Duke University61Press, draws referees who routinely re-derive a denominator or re-run a Kitagawa split by hand. The62deposit must let them do so. Calibrate the package against the data class you actually used.6364| Data class | Typical source | Deposit obligation |65|------------|----------------|--------------------|66| Fully public | HMD, HFD, IPUMS, WPP, published vital statistics | Extract code + constructed analytic file (where license permits) + persistent ID |67| Public-but-licensed | IPUMS, DHS, redistribution-restricted census | Extract specification + code, not raw microdata; cite the provider's persistent access path |68| Restricted/confidential | Linked administrative records, RDC-only census, linked mortality files | Code + synthetic stand-in file + exact access-conditions note |6970## Referee-pushback patterns and the Demography-specific fix7172- *"I cannot tell which HMD/HFD vintage produced these rates."* -> Record the release label and download73 date in the README and a code comment; vintages revise historical rates.74- *"The decomposition components in the deposit do not sum to the headline number."* -> Add an assertion75 that components reconcile to the total e0 (or TFR) change before you deposit; ship the check passing.76- *"Your bootstrap intervals are not reproducible."* -> Set and report a seed for every resampling,77 microsimulation, and graduation step; an un-seeded interval reads as un-reproducible.78- *"You say data are restricted but give no way to obtain them."* -> Name the data enclave or79 application pathway and the access conditions; a bare "restricted" reads as evasion.8081## Output format8283```84【Data statement】public / restricted / on request — drafted with persistent ID? [Y/N]85【Repository】FAIR repo + DOI/accession (not personal URL)? [Y/N]86【Reproducible code】master script + comments + recorded versions + seeds? [Y/N]87【Exhibits match deposit?】[Y/N]88【Restricted data?】access conditions described + synthetic data where feasible?89【Next】demog-review-process90```9192## Supplementary resources9394- [`../../resources/external_tools.md`](../../resources/external_tools.md) — FAIR repositories and reproducibility tooling95- [`../../resources/official-source-map.md`](../../resources/official-source-map.md) — Demography data-availability and reproducible-code policy