1  Procurando (e pedindo) ajuda para o R

Aprender a programar em R envolve, inevitavelmente, encontrar desafios e dúvidas ao longo do caminho. Mas não se preocupe, a comunidade R é vasta e receptiva, e existem inúmeras maneiras de encontrar auxílio e solucionar seus problemas.

Antes de recorrer a outras pessoas, no entanto, é fundamental desenvolver a autonomia na busca por soluções. A documentação do R e os fóruns online são excelentes recursos para aprimorar suas habilidades e encontrar respostas para suas dúvidas. A grande maioria dos pacotes e funções do R possuem uma boa documentação com exemplos de utilização. Os fóruns na web trazem respostas para as perguntas mais frequente. (In)felizmente, 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 Consultando a documentação do R

O R possui uma extensa e detalhada documentação que abrange funções, pacotes e outros recursos da linguagem. Essa documentação pode ser acessada diretamente no R através das funções help e ? que são equivalentes entre si.

Experimente digitar ?sum ou help(sum) para ver a documentação desta função, que calcula a soma de elementos numéricos:

Figura 1.1: Ajuda da função sum

A documentação geralmente inclui uma descrição da função, seus argumentos, exemplos de uso e referências adicionais. Os 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

Dicas extras:

  • Utilize help.search() para buscar por palavras-chave na documentação. Exemplo: help.search("linear regression").

  • Acesse a documentação de um pacote específico com help(package = "nome_do_pacote"). Exemplo: help(package = "ggplot2").

Explore a documentação e familiarize-se com as diferentes formas de encontrar informações sobre as funções e pacotes do R.

1.2 Buscando ajuda online

A internet oferece uma vasta gama de recursos para aprender e solucionar dúvidas sobre R. 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 510 mil 1. 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 fit2

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). É muito difícil conseguir ajudar baseado apenas em uma foto da tela, ainda mais de baixa qualidade e difícil de ler/entender.3

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

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:

  • Descreva o que você está tentando fazer, qual o objetivo do seu código e qual o resultado esperado. Indique qual o erro que está acontecendo e o que você já tentou para resolver.

  • Compartilhe seu código de alguma dessas maneiras:

    • Compacte4 e compartilhe todo o diretório do seu projeto.

    • Compartilhe seu projeto do RStudio Cloud.

  1. ano de 2025↩︎

  2. Suas buscas terão mais resultados se usar as palavras-chave em inglês.↩︎

  3. Baseado em fatos reais.↩︎

  4. Com algum programa como o 7-zip.com↩︎