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!