Capítulo 1 Procurando (e pedindo) ajuda para o R

Antes de pedir ajuda, é sempre uma boa prática estudar para tentar resolver por si mesmo. A grande maioria dos pacotes e funções do R possuem uma boa documentação com exemplos de utilização. Também há diversos fóruns na web especializados com respostas para as perguntas mais frequente e sites com tutoriais detalhados.

Infelizmente, muitos dos textos de ajuda estão na língua inglesa. Aproveite esta chance para treinar e melhorar sua leitura em inglês.

1.1 As funções help e ?

As funções help e ? fornecem acesso à documentação no próprio R e são equivalentes entre si.

Experimente digitar ?sum para ver a documentação desta função:

Figura 1.1: Ajuda da função sum

Na documentação, é usual haver uma parte com exemplos de uso da função. Estes exemplos podem ser executados com a função example:

example(sum) 

## 
## sum> ## Pass a vector to sum, and it will add the elements together.
## sum> sum(1:5)
## [1] 15
## 
## sum> ## Pass several numbers to sum, and it also adds the elements.
## sum> sum(1, 2, 3, 4, 5)
## [1] 15
## 
## sum> ## In fact, you can pass vectors into several arguments, and everything gets added.
## sum> sum(1:2, 3:5)
## [1] 15
## 
## sum> ## If there are missing values, the sum is unknown, i.e., also missing, ....
## sum> sum(1:5, NA)
## [1] NA
## 
## sum> ## ... unless  we exclude missing values explicitly:
## sum> sum(1:5, NA, na.rm = TRUE)
## [1] 15

1.2 Stack Overflow

O stackoverflow.com é um site bem organizado especializado na discussão de assuntos relativos à programação. Tópicos marcados com a tag “r” chegam a mais de 440 mil ⁵. Para acessar todos os tópicos com a tag “r”, acesse stackoverflow.com/questions/tagged/r.

Este site tem a vantagem de ser bem fácil de fazer buscas. Tente digitar, na caixa de buscas, a seguinte expressão: [r] logistic regression fit⁶

Figura 1.2: Busca no site (stackoverflow.com)[(https://stackoverflow.com]

1.3 Pedir ajuda ao seu professor

Antes de tudo, vou mostrar um exemplo de como não pedir ajuda ao professor (Figura 1.3:

Figura 1.3: É difícil ajudar com uma foto da tela com baixa qualidade

É muito difícil conseguir ajudar baseado apenas em uma foto da tela, ainda mais de baixa qualidade e difícil de ler/entender.⁷

Formular uma boa pergunta é 90% do desafio e, muitas vezes, o processo de formular a pergunta já fornece a própria resposta.

Para conseguir ajuda mais rápida e com maior chance de ser adequadamente respondida, siga alguma destas recomendações:

• Compacte⁸ e compartilhe todo o diretório do seu projeto;
• Compartilhe seu projeto do RStudio Cloud;
• Utilize o pacote reprex (Seção 1.4).

1.4 O pacote reprex

Reprex é a sigla para reproducible example, ou exemplo reproduzível. O código que você deseja compartilhar deve ser renderizado dentro da função reprex::reprex, como código completo dentro de chaves { }.

reprex::reprex({
  y <- c(1,2,3,4,"a")
  mean(y)
})

Esta função cria um arquivo renderizado com o exemplo e também envia o resultado direto para a área de transferência para poder ser colado com o + .

O resultado da função acima pode ser visto abaixo:

y <- c(1,2,3,4,"a")
mean(y)
#> Warning in mean.default(y): argumento não é numérico nem lógico: retornando NA
#> [1] NA