4. Como obter ajuda para uso do R?

Muitas vezes, quando estamos escrevendo scripts nos deparamos com erros ou uma nova função, principalmente quando estamos aprendendo a analisar dados por meio do software R. Nestes momentos, necessitamos de ajuda para entender algum conceito, a utilizar pacotes, suas funções e a como escrever seus argumentos.

Isso é normal. Todos que trabalham com linguagem de programação acessam mídias sociais, fóruns e páginas da web em busca de informações, técnicas e métodos que ajude a solucionar desafios ou problemas. Algumas das principais formas para se pedir ajuda são:

  1. O Help ou documentação do R [link de acesso: https://cran.r-project.org/manuals.html].
  2. Google [link de acesso: https://www.google.com].
  3. Fóruns como o Stack Overflow [link de acesso: https://pt.stackoverflow.com].
  4. Grupos com outros profissionais de saúde que analisam dados com R.


a) O Help ou documentação do R

Durante a sua escrita de script você pode acessar informações no próprio R. Para acessar essas informações é necessário digitar um ponto de interrogação (?) seguido do nome da função ou comando que quer executar. Ou ainda pode-se, utilizar a função help() com o nome da função entre parênteses no script e clicar em run. Faça um teste em seu Rstudio e digite a função help() para a função de raiz quadrada sqrt():

help(sqrt)

Observe que ao escrever o comando help(sqrt), irá abrir uma janela na aba de ajuda (Help) no RStudio. Com o tempo, você irá se familiarizar com os diferentes termos e conceitos do R e conseguirá utilizar a documentação de cada função com facilidade. Muitas vezes, erros e problemas poderão ser solucionados por um entendimento da documentação no próprio R.

Uma forma muito útil para buscar ajuda ou retirar dúvida do R é digitando os erros que você visualiza no output lá nas plataformas de ajuda: Google ou Stackoverflow. A linguagem R é amplamente difundida pelo mundo. Muitas pessoas a utilizam e, frequentemente, se deparam com erros que você pode se deparar também. Dificilmente, iremos nos deparar com uma dúvida nunca respondida.


b) O Google

Veja na Figura 20 como buscamos uma dúvida no Google. Uma dica seria iniciar colocando a letra R seguida de palavras chaves que remetem à questão:


Figura 20: Tela de busca do Google.


Também poderá colar no “buscador google” literalmente a mensagem de erro emitida pelo R, o que pode te apoiar a encontrar uma solução mais rápida.


c) O Stackoverflow

Veja na Figura 21 como buscamos uma dúvida no Stackoverflow, um site gratuito de perguntas e respostas sobre programação com perguntas e respostas feitas por pessoas que estão escrevendo códigos. Para utilizá-lo, assim como no Google você pode iniciar colocando a letra R seguida de palavras chaves ou a própria questão:


Figura 21: Tela de busca do Stackoverflow.


Você também poderá colar no “buscador” do Stackoverflow literalmente a mensagem de erro emitida pelo R, o que pode te apoiar a encontrar uma solução mais rápida.



Próximo módulo

Pronto chegamos ao final do nosso módulo! Agora você já conhece todas as funções básicas para uso da linguagem R. Acesse os demais módulos deste curso para colocar em prática as análises de dados necessárias para estabelecer rotinas de trabalho na vigilância em saúde.

Até ao próximo módulo!