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:
- O Help ou documentação do R [link de acesso: https://cran.r-project.org/manuals.html].
- Google [link de acesso: https://www.google.com].
- Fóruns como o Stack Overflow [link de acesso: https://pt.stackoverflow.com].
- 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.
Materiais de apoio
Caso queira se aprofundar no conteúdo, recomendamos os seguintes materiais complementares:
- https://www.rdocumentation.org
- https://www.rstudio.com/resources/cheatsheets/
- https://livro.curso-r.com/1-instalacao.html
- https://appliedepi.org/tutorial/#data-preparation
- https://bookdown.org/rdpeng/rprogdatascience/
- https://listas.inf.ufpr.br/cgi-bin/mailman/listinfo/r-br
- https://cran.r-project.org/other-docs.html#nenglish
- https://r4ds.had.co.nz/
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!