Dados e Reprodutibilidade (demog-data-and-reproducibility)
A Demography solicita que todo manuscrito aceito apresente uma declaração de disponibilidade de dados e incentiva código reproduzível. A revista não mantém repositório próprio — você escolhe um repositório FAIR e fornece identificadores persistentes. Construa os materiais ao longo do processo para que a aceitação não pare.
Quando acionar
- Construindo os materiais de reprodutibilidade/replicação e a declaração de disponibilidade de dados
- Um manuscrito foi aceito e você precisa finalizar a declaração e fazer o depósito
- Os dados não podem ser totalmente compartilhados (privacidade, confidencialidade, restrições do provedor/proprietário) e você precisa da linguagem de isenção
- Escolhendo um repositório e um identificador persistente
O que a Demography exige (verifique a redação atual na página de ética/divulgações)
- Declaração de disponibilidade de dados. Manuscritos aceitos devem incluir uma declaração confirmando se e como os dados foram compartilhados. Para dados publicamente disponíveis, descreva o método de acesso com um identificador persistente (DOI ou número de acesso).
- Identificadores persistentes + repositório FAIR. Como a Demography não hospeda repositório, deposite dados e materiais em um repositório alinhado ao FAIR (por exemplo, ICPSR/openICPSR, Harvard Dataverse, Zenodo, OSF) e cite-o com um link permanente — não um site pessoal ou pasta genérica na nuvem. Encontre um via FAIRsharing.org ou re3data.org.
- Código reproduzível (incentivado). Forneça código que regenere os resultados, com versões de software registradas e comentários informativos explicando cada etapa. Trate isso como esperado, não opcional, para um artigo demográfico quantitativo.
- Dados restritos. Quando o acesso for limitado para proteger informações confidenciais ou proprietárias, descreva as condições que limitam o acesso e como outros podem obter os dados, alinhando-se aos princípios FAIR tanto quanto possível.
Lista de verificação "construa conforme avança"
- Declaração de disponibilidade de dados redigida (público / restrito / mediante solicitação) com IDs persistentes
- Dados + materiais depositados em um repositório FAIR com um DOI/número de acesso
- Um script mestre que regenere todas as tabelas, figuras, tábuas de vida e decomposições
- README documenta a proveniência/data dos dados, construção de taxas/exposição e como reproduzir cada exibição
- Código comentado e versões de software/pacotes registradas (
renv.lock/requirements.txt/ instalações) - Sementes definidas e relatadas para bootstrap, simulação, microssimulação
- Números das exibições no manuscrito correspondem exatamente à saída depositada
- Dados restritos: nota de isenção + condições de acesso + dados sintéticos quando viáveis
Antipadrões
- Tratar a declaração de dados como uma formalidade de última hora na aceitação
- Um URL pessoal ou link genérico na nuvem em vez de um identificador persistente em um repositório FAIR
- Código não documentado, sem semente, sem comentários que "funciona na minha máquina"
- Afirmar que os dados são restritos sem descrever as condições de acesso
- Chamar a taxa de gestão editorial de $1.000 de "acesso aberto" ou "taxa de dados" (não é nenhum dos dois)
O que um revisor de reprodutibilidade espera na Demography
A Demography, carro-chefe da Population Association of America publicado em acesso aberto pela Duke University Press, atrai revisores que rotineiramente recalculam um denominador ou executam uma decomposição de Kitagawa manualmente. O depósito deve permitir que eles o façam. Calibre o pacote de acordo com a classe de dados que você realmente usou.
| Classe de dados | Fonte típica | Obrigação de depósito |
|---|---|---|
| Totalmente público | HMD, HFD, IPUMS, WPP, estatísticas vitais publicadas | Código de extração + arquivo analítico construído (onde a licença permitir) + ID persistente |
| Público mas licenciado | IPUMS, DHS, censo com restrição de redistribuição | Especificação de extração + código, não microdados brutos; cite o caminho de acesso persistente do provedor |
| Restrito/confidencial | Registros administrativos vinculados, censo apenas em RDC, arquivos de mortalidade vinculados | Código + arquivo sintético substituto + nota exata das condições de acesso |
Padrões de objeções de revisores e a solução específica da Demography
- "Não consigo identificar qual safra do HMD/HFD produziu essas taxas." -> Registre o rótulo da versão e a data de download no README e em um comentário do código; as safras revisam taxas históricas.
- "Os componentes da decomposição no depósito não somam ao número principal." -> Adicione uma asserção de que os componentes se reconciliam com a mudança total de e0 (ou TFR) antes de depositar; envie a verificação aprovada.
- "Seus intervalos de bootstrap não são reproduzíveis." -> Defina e relate uma semente para cada etapa de reamostragem, microssimulação e graduação; um intervalo sem semente é lido como não reproduzível.
- "Você diz que os dados são restritos, mas não fornece como obtê-los." -> Nomeie o enclave de dados ou caminho de solicitação e as condições de acesso; um simples "restrito" é lido como evasão.
Formato de saída
【Declaração de dados】público / restrito / mediante solicitação — redigida com ID persistente? [S/N]
【Repositório】Repositório FAIR + DOI/número de acesso (não URL pessoal)? [S/N]
【Código reproduzível】Script mestre + comentários + versões registradas + sementes? [S/N]
【Exibições correspondem ao depósito?】[S/N]
【Dados restritos?】Condições de acesso descritas + dados sintéticos quando viáveis?
【Próximo】processo-de-revisão-demog
Recursos complementares
../../resources/external_tools.md— Repositórios FAIR e ferramentas de reprodutibilidade../../resources/official-source-map.md— Política de disponibilidade de dados e código reproduzível da Demography