A base de uma boa pergunta reprodutível é que deve ser possível que o seu problema¹ apareça como problema para aqueles que irão tentar entendê-lo e resolvê-lo.
Linhas gerais
Para que possamos reproduzir seu problema o seguinte passo-a-passo pode ser seguido:
- Tente reproduzir seu problema em sua máquina antes de enviá-lo ao StackOverflow.
- Forneça o código que produziu (e que deverá reproduzir no computador alheio) o comportamento que motiva a pergunta.
- Forneça dados capazes de reproduzir o problema.
- Forneça o resultado esperado pelo código fornecido em 1.
1. Como reproduzir meu problema?
Abra um novo script e um novo ambiente. Se você estiver utilizando o RStudio você pode iniciar um nova seção clicando em Session
na barra superior e depois New Session
. Caso esteja usando o R
(Rgui, R pela linha de comando, etc), basta abrir o programa mais um vez.
Neste novo ambiente copie o script original e vá rodando linha por linha até que se depare com o problema novamente. Este método permite isolar o problema nos seus determinantes fundamentais. Caso você esteja trabalhando em um script de 200 linhas, mas o erro acontece na linha 53, não há motivo para compartilhar as 147 linhas que se seguem ao erro e provavelmente boa parte das primeiras 53 linhas também podem ser excluídas do código que será partilhado.
Uma vez identificada a origem do problema, forneça aquela linha de código e apenas as demais linhas necessárias para reproduzir o problema. Digamos que o erro foi encontrado em:
sum(x)
Neste caso é necessário que também saibamos o que é x
, ou seja, forneça o(s) objeto(s) x
no estado em que eles entraram na chamada da função (ver item 3).
2. Como compartilhar meu código?
A maneira mais adequada é copiando e colando o texto do seu código. Parece trivial, mas essa não é a única forma de fornecer o código.
Caso esteja se deparando com um erro ou aviso, forneça a mensagem.
sum(x)
Error in sum(x) : invalid 'type' (character) of argument
3. Como fornecer dados?
Como comentado acima, seus dados devem ser fornecidos no estado em que estavam quando o erro ocorreu. Para isso quando se deparar com o erro, utilize a função dput
para fornecer seu objeto tal como ele se encontra.
dput(x)
c("1", "2", "3", "4", "5", "6")
A função dput
permite que seu objeto seja recriado em outra máquina, mesmo que ele tenha sido obtido de uma base de dados ou arquivo ou outra forma. Caso seu objeto seja muito grande utilize dput(head(objeto, 30))
ou alguma outra forma de limitar o tamanho do objeto.
Há aqueles que gostam de fornecer as linhas de código que criaram o objeto. Ocorre que entre iniciantes é muito comum alterar o objeto posteriormente e, portante, o estado do objeto na linha original e na linha que gerou o erro podem (eu diria devem) mudar. Por esta razão utilizar dput
garante maior reprodutibilidade do código e deve ser preferido.
Este é o caso no exemplo de erro que estou utilizando aqui:
x <- 1:5
x <- c(x, '6')
sum(x)
Error in sum(x) : invalid 'type' (character) of argument
Caso seu código precise de alguma simulação, utilize set.seed(1)
(ou qualquer outro número) para garantir que os resultados serão o mesmo em sua máquina e na daqueles que pretendem auxiliá-lo.
4. Como compartilhar o resultado esperado?
Isto pode ser feito de muitas formas. É possível utilizar um link ou imagem que contém o resultado esperado (no caso de um gráfico, como este exemplo). Também é possível descrever com palavras o que espera, como neste caso.
1: Problema aqui não precisa ser entendido como um erro, mas simplesmente como a motivação da pergunta
R
as diretrizes gerais sobre perguntas reprodutíveis.