Transparência e Dados de Replicação (jpam-transparency-and-data)
O JPAM publica avaliações de programas que frequentemente informam decisões reais de gastos, portanto, as evidências devem ser reproduzíveis. O periódico espera que os autores arquivem os dados e o código por trás dos resultados reportados em um repositório público adequado, com uma declaração clara de disponibilidade de dados. Construa o pacote enquanto avança para que não atrase a aceitação — e planeje com antecedência os dados administrativos restritos comuns em trabalhos de políticas públicas. Verifique a redação atual em Wiley Authors / Research Exchange antes do upload (recuperado em 2026-06-20; o site oficial é a referência).
Quando acionar
- Construindo o pacote de replicação (dados + código + documentação)
- Um manuscrito está caminhando para a aceitação e os materiais são solicitados
- Os dados são restritos (administrativos, protegidos por IRB, licenciados pelo provedor) e você precisa da via de isenção
- Redigindo a declaração de disponibilidade de dados
O que preparar
- Depósito público. Coloque os materiais de replicação em um repositório reconhecido (por exemplo, o arquivo ICPSR/openICPSR do projeto, Harvard Dataverse, OSF ou um repositório designado pelo periódico) com um identificador persistente — e não um site pessoal ou link de nuvem temporário. Declarações recentes de disponibilidade de dados do JPAM geralmente usam um repositório JPAM/Harvard Dataverse, enquanto o Research Exchange controla a solicitação exata do repositório.
- Reproduza cada número reportado. Um script mestre regenera cada tabela e figura a partir dos dados brutos/construídos. Os números dos exhibits no manuscrito devem corresponder exatamente à saída do pacote.
- Documentação. Um README cobrindo a proveniência dos dados, etapas de construção, versões de software/pacotes, sementes para etapas estocásticas e o comando exato para reproduzir cada exhibit.
- Declaração de disponibilidade de dados. Informe o que é compartilhado, onde e sob qual licença; se os dados forem restritos, declare precisamente o porquê e como um replicador pode obter acesso.
Dados administrativos restritos (o caso da pesquisa em políticas públicas)
A avaliação de políticas frequentemente utiliza microdados administrativos ou de pesquisas vinculados que não podem ser publicados. A expectativa de transparência do JPAM é atendida de forma honesta:
- Explicando a restrição (legal, IRB, licença do provedor de dados) na declaração de disponibilidade de dados.
- Fornecendo instruções de acesso — o processo de solicitação, contato do provedor e cronograma aproximado para que um replicador independente possa obter os mesmos dados.
- Publicando todo o código mais quaisquer arquivos derivados/agregados compartilháveis e, quando viável, dados sintéticos ou simulados que permitam que o código seja executado de ponta a ponta.
Lista de verificação "construa enquanto avança"
- Um script mestre regenera cada tabela e figura
- README: proveniência, construção, versões, sementes, etapas de reprodução por exhibit
- Versões de software/pacotes fixadas (
renv.lock/requirements.txt/ instalações registradas) - Números dos exhibits do manuscrito correspondem exatamente à saída do pacote
- Repositório público com identificador persistente escolhido (designado pelo periódico quando especificado)
- Declaração de disponibilidade de dados redigida
- Dados restritos: restrição explicada + caminho de acesso + dados sintéticos quando viável
Antipadrões
- Tratar o pacote como uma reflexão posterior pós-aceitação (pode travar a publicação)
- Depositar código que na verdade não reproduz as tabelas/figuras impressas
- Um URL pessoal ou link de nuvem expirante em vez de um repositório persistente
- Alegar que os dados são restritos sem caminho de acesso ou substituto sintético
- Código não documentado, sem sementes, sem versões fixadas que só "funciona na minha máquina"
Âncoras de calibração (com ressalvas)
- Avaliações de políticas dependem fortemente de dados administrativos restritos; uma nota de restrição honesta acompanhada de um caminho de acesso real e código executável em dados sintéticos/derivados é a rota esperada e aceita — e não uma brecha para pular a transparência.
- O requisito exato de depósito, a solicitação do repositório e o fluxo de verificação de reprodução podem mudar; confirme a redação atual da política de dados em Wiley Authors / Research Exchange.
- Construa o pacote junto com a análise: adaptar a reprodutibilidade após a aceitação é onde os artigos de políticas públicas emperram.
Microexemplo ilustrativo
Uma avaliação de reforma da assistência social usa registros vinculados de seguro-desemprego estadual e TANF que não podem ser publicados. O pacote ainda atende ao requisito: uma declaração de disponibilidade de dados explica a restrição de licenciamento e nomeia o processo e cronograma de solicitação de dados da agência estadual; todo o código é depositado com um script mestre; um conjunto de dados sintético correspondendo à estrutura das variáveis permite que um replicador execute o pipeline completo; e tabelas agregadas compartilháveis são incluídas. Um pesquisador independente poderia obter os dados reais e reproduzir cada número. (Ilustrativo.)
Formato de saída
【Repository】arquivo público + ID persistente — escolhido? [S/N]
【Reproduces results?】script mestre verificado localmente? [S/N]
【Documentation】README + proveniência + sementes + versões fixadas? [S/N]
【Restricted data?】restrição explicada + caminho de acesso + dados sintéticos? [S/N]
【Data-availability statement】redigida? [S/N]
【Next】jpam-review-process
Recursos complementares
../../resources/official-source-map.md— evidências da política de dados/replicação do JPAM e diretrizes de repositórios../../resources/external_tools.md— repositórios e ferramentas de reprodutibilidade para projetos com dados restritos